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()