Temporal.Instant.prototype.subtract()

語法

subtract(duration)

引數

duration

一個字串、一個物件或一個 Temporal.Duration 例項，表示要從當前時間點減去的一個時長。它使用與 Temporal.Duration.from() 相同的演算法轉換為 Temporal.Duration 物件。

返回值

一個新的 Temporal.Instant 物件，表示從當前時間點減去 duration。如果 duration 為正，則返回的時間點比當前時間點早；如果 duration 為負，則返回的時間點比當前時間點晚。

異常

RangeError

在以下情況之一中丟擲

• duration 是一個 日曆時長（即 years、months 或 weeks 具有非零值），或者 days 具有非零值，因為在沒有日曆和時間參照的情況下，日曆時長的含義是不明確的。
• 結果不在可表示範圍內，該範圍是距 Unix 紀元 ±10⁸ 天，或約 ±273,972.6 年。

描述

減去一個時長等同於 加上 其 相反數，因此所有相同的注意事項均適用。

示例

減去一個 Temporal.Duration

const instant = Temporal.Instant.fromEpochMilliseconds(1000);
const duration = Temporal.Duration.from("PT1S"); // One-second duration
const newInstant = instant.subtract(duration);
console.log(newInstant.epochMilliseconds); // 0

更多示例，請參閱 add()。

規範

瀏覽器相容性

另見

• Temporal.Instant
• Temporal.Duration
• Temporal.Instant.prototype.add()
• Temporal.Instant.prototype.since()
• Temporal.Instant.prototype.until()