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