Temporal.PlainTime.prototype.subtract()

可用性有限

此特性不是基線特性，因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性： 這是一項實驗性技術
在生產中使用此技術之前，請仔細檢查瀏覽器相容性表格。

subtract() 方法用於 Temporal.PlainTime 例項，它會返回一個新的 Temporal.PlainTime 物件，表示將當前時間向後推移指定的時長（時長可透過 Temporal.Duration.from() 轉換），必要時會自動迴圈。

如果您想計算兩個時間之差並得到一個時長，請改用 since() 或 until()。

語法

subtract(duration)

duration: 一個字串、一個物件或一個 Temporal.Duration 例項，表示要從當前時間減去的時長。它將使用與 Temporal.Duration.from() 相同的演算法轉換為 Temporal.Duration 物件。

一個新的 Temporal.PlainTime 物件，表示原始 PlainTime 指定的時間減去該時長後的結果。

減去一個時長等同於加上該時長的負值，因此所有相同的注意事項都適用。

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

此頁面最後修改於 2025年7月10日，由 MDN 貢獻者編輯。