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

瀏覽器相容性

另見