Temporal.Duration.prototype.subtract()

语法

subtract(other)

参数

其他

一个字符串、一个对象或一个 Temporal.Duration 实例，表示要添加到当前 duration 的 duration。它会使用与 Temporal.Duration.from() 相同的算法转换为 Temporal.Duration 对象。

返回值

一个表示当前 duration 与 other 之间差值的新 Temporal.Duration 对象。

异常

RangeError

在以下情况之一中抛出

• this 或 other 是一个日历 duration（即 years、months 或 weeks 的值非零），因为在没有日历和时间参照的情况下，日历 duration 是模糊的。
• this 和 other 的差值溢出了可表示 duration 的最大值或最小值，即 ±2⁵³ 秒。

示例

使用 subtract()

const d1 = Temporal.Duration.from({ hours: 1, minutes: 30 });
const d2 = Temporal.Duration.from({ hours: -1, minutes: -20 });

const d3 = d1.subtract(d2);
console.log(d3.toString()); // "PT2H50M"

有关更多示例和注意事项，请参阅 add() 方法。

规范

浏览器兼容性

另见

• Temporal.Duration
• Temporal.Duration.prototype.add()
• Temporal.Duration.prototype.negated()