Temporal.PlainTime.prototype.add()

可用性有限

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

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

add() 方法是 Temporal.PlainTime 实例的方法,它会返回一个新的 Temporal.PlainTime 对象,表示将当前时间向前推移给定时间量(可以通过 Temporal.Duration.from() 转换的格式),必要时会进行时钟换算。

语法

js
add(duration)

参数

duration

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

返回值

一个新的 Temporal.PlainTime 对象,表示原始 PlainTime 指定的时间加上时间量。任何大于 hours 的单位都会被忽略,如果时间超过午夜,它将换算到下一天。

添加一个时间量相当于 减去相反数

示例

添加持续时间

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

const end2 = start.add({ hours: -1, minutes: -30 });
console.log(end2.toString()); // 11:04:56

const distance = Temporal.PlainTime.from("00:00:00").until("01:23:45"); // 1h 23m 45s
const end3 = start.add(distance);
console.log(end3.toString()); // 13:58:41

时间换算

如果时间超过午夜,它将换算到下一天。

js
const start = Temporal.PlainTime.from("12:34:56");
const end = start.add({ hours: 12 });
console.log(end.toString()); // 00:34:56

规范

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

浏览器兼容性

另见