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 |
浏览器兼容性
加载中…