Temporal.Duration.prototype.months

可用性有限

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

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

months 訪問器屬性,屬於 Temporal.Duration 例項,返回一個整數,表示 duration 中的月數。

除非 duration 是平衡的,否則您無法確定此值的範圍,但可以透過檢查 duration 的 sign 屬性來了解其符號。如果它被平衡到高於月份的單位,則 months 的絕對值的範圍取決於日曆(一年中有多少個月)。

months 的 set 訪問器是 undefined。您不能直接更改此屬性。請使用 with() 方法建立一個具有所需新值的 Temporal.Duration 新物件。

示例

使用 months

js
const d1 = Temporal.Duration.from({ years: 1, months: 1 });
const d2 = Temporal.Duration.from({ years: -1, months: -1 });
const d3 = Temporal.Duration.from({ years: 1 });
const d4 = Temporal.Duration.from({ months: 12 });

console.log(d1.months); // 1
console.log(d2.months); // -1
console.log(d3.months); // 0
console.log(d4.months); // 12

// Balance d4
const d4Balanced = d4.round({
  largestUnit: "years",
  relativeTo: Temporal.PlainDate.from("2021-01-01"), // ISO 8601 calendar
});
console.log(d4Balanced.months); // 0
console.log(d4Balanced.years); // 1

規範

規範
Temporal
# sec-get-temporal.duration.prototype.months

瀏覽器相容性

另見