Temporal.Duration.prototype.weeks

可用性有限

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

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

weeks 訪問器屬性是 Temporal.Duration 例項的一個屬性，它返回一個整數，表示持續時間中的週數。

除非該持續時間是平衡的，否則您無法假定此值的範圍，但可以透過檢查其 sign 屬性來了解其符號。如果它被平衡到比周更高的單位，則 weeks 的絕對值的範圍取決於日曆（一個月或一年中有多少周）。

weeks 的設定訪問器是 undefined。您無法直接修改此屬性。請使用 with() 方法來建立一個新的 Temporal.Duration 物件，幷包含您想要的新值。

示例

使用 weeks

const d1 = Temporal.Duration.from({ weeks: 1, days: 1 });
const d2 = Temporal.Duration.from({ weeks: -1, days: -1 });
const d3 = Temporal.Duration.from({ weeks: 1 });
const d4 = Temporal.Duration.from({ days: 7 });

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

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

規範

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

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

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

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