Temporal.Duration.prototype.weeks

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

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

Sofern die Dauer nicht ausgeglichen ist, können Sie den Bereich dieses Wertes nicht annehmen, aber Sie können das Vorzeichen erkennen, indem Sie die sign-Eigenschaft der Dauer überprüfen. Wenn sie auf eine Einheit über den Wochen ausgeglichen wird, hängt der Bereich des Absolutwertes von weeks vom Kalender ab (wie viele Wochen in einem Monat oder Jahr sind).

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

Beispiele

Verwendung von Wochen

js
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: "week",
  relativeTo: Temporal.PlainDate.from("2021-01-01"), // ISO 8601 calendar
});
console.log(d4Balanced.weeks); // 1
console.log(d4Balanced.days); // 0

Spezifikationen

Specification
Temporal proposal
# sec-get-temporal.duration.prototype.weeks

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch