Temporal.Duration.prototype.weeks

Die weeks Accessor-Eigenschaft von Temporal.Duration-Instanzen gibt eine ganze Zahl zurück, die die Anzahl der Wochen in der Zeitspanne darstellt.

Sofern die Zeitspanne nicht ausbalanciert ist, können Sie den Bereich dieses Wertes nicht annehmen, jedoch können Sie das Vorzeichen überprüfen, indem Sie die sign-Eigenschaft der Zeitspanne überprüfen. Falls sie auf eine Einheit oberhalb von Wochen ausbalanciert ist, hängt der Bereich des Absolutwertes von weeks vom Kalender ab (wie viele Wochen ein Monat oder Jahr umfasst).

Der Set-Accessor von weeks ist undefined. Sie können diese Eigenschaft nicht direkt ändern. Verwenden Sie die with()-Methode, um ein neues Temporal.Duration-Objekt mit dem gewünschten neuen Wert zu erstellen.

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