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 |
瀏覽器相容性
載入中…