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 上查看此页面 • 报告此内容的问题