Temporal.PlainYearMonth.prototype.until()

可用性有限

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

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

until() 方法用於 Temporal.PlainYearMonth 例項，返回一個新的 Temporal.Duration 物件，該物件表示從當前年月到另一個年月的時長（可由 Temporal.PlainYearMonth.from() 轉換）。如果另一個年月在當前年月之後，則時長為正；如果在此之前，則時長為負。

此方法執行 other - this。要執行 this - other，請使用 since() 方法。

語法

until(other)
until(other, options)

引數

其他: 一個字串、物件或 Temporal.PlainYearMonth 例項，表示要從中減去當前年月的年月。它使用與 Temporal.PlainYearMonth.from() 相同的演算法轉換為 Temporal.PlainYearMonth 物件。它必須與 this 具有相同的日曆。
options 可選: 與 since() 相同的選項。

返回值

一個新的 Temporal.Duration 物件，表示從當前年月 *直到* other 的時長。如果 other 在當前年月之後，則時長為正；如果在此之前，則時長為負。

異常

RangeError

在以下情況之一中丟擲

other 的日曆與 this 不同。
任何選項無效。

示例

使用 until()

const launch = Temporal.PlainYearMonth.from("2035-01");
const now = Temporal.Now.plainDateISO().toPlainYearMonth();
const duration = now.until(launch);
console.log(`It will be ${duration.toLocaleString("en-US")} until the launch`);

更多示例，請參閱 since()。

規範

規範
Temporal # sec-temporal.plainyearmonth.prototype.until

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

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

在 GitHub 上檢視此頁面 • 報告此內容的可能問題