Temporal.PlainTime.prototype.subtract()

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

subtract() 方法用于 Temporal.PlainTime 实例,它会返回一个新的 Temporal.PlainTime 对象,表示将当前时间向后推移指定的时长(时长可通过 Temporal.Duration.from() 转换),必要时会自动循环。

如果您想计算两个时间之差并得到一个时长,请改用 since()until()

语法

js
subtract(duration)

参数

duration

一个字符串、一个对象或一个 Temporal.Duration 实例,表示要从当前时间减去的时长。它将使用与 Temporal.Duration.from() 相同的算法转换为 Temporal.Duration 对象。

返回值

一个新的 Temporal.PlainTime 对象,表示原始 PlainTime 指定的时间减去该时长后的结果。

减去一个时长等同于加上该时长的负值,因此所有相同的注意事项都适用。

示例

减去一个持续时间

js
const start = Temporal.PlainTime.from("12:34:56");
const end = start.subtract({ hours: 1, minutes: 30 });
console.log(end.toString()); // 11:04:56

有关更多示例,请参阅 add()

规范

规范
Temporal
# sec-temporal.plaintime.prototype.subtract

浏览器兼容性

另见