Temporal.PlainDate.prototype.weekOfYear
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 Zugriffs-Eigenschaft weekOfYear von Temporal.PlainDate-Instanzen gibt eine positive ganze Zahl zurück, die den 1-basierten Wochenindex im yearOfWeek dieses Datums darstellt, oder undefined, wenn der Kalender kein gut definiertes Wochensystem hat. Die erste Woche des Jahres ist 1. Sie ist abhängig vom Kalender.
Beachten Sie, dass für ISO 8601 die ersten und letzten Tage des Jahres der letzten Woche des Vorjahres oder der ersten Woche des nächsten Jahres zugeschrieben werden können. Wenn eine Woche zwei Jahre überschreitet, gehört sie zu dem Jahr, in dem sie die meisten Tage hat. Um das Jahr zu erhalten, zu dem die weekOfYear gehört, verwenden Sie die Eigenschaft yearOfWeek, nicht die Eigenschaft year.
Der Set-Zugriff von weekOfYear ist undefined. Sie können diese Eigenschaft nicht direkt ändern. Um ein neues Temporal.PlainDate-Objekt mit dem gewünschten neuen weekOfYear-Wert zu erstellen, verwenden Sie die Methode add() oder subtract() mit der entsprechenden Anzahl von weeks.
Beispiele
Verwendung von weekOfYear
const date = Temporal.PlainDate.from("2021-07-01");
console.log(date.weekOfYear); // 26
// If 01-01 is a Friday/Saturday/Sunday, it belongs to the last week of the previous year
const date2 = Temporal.PlainDate.from("2021-01-01");
console.log(date2.dayOfWeek); // 5
console.log(date2.weekOfYear); // 53; 2020 has 53 weeks
console.log(date2.yearOfWeek); // 2020
// Otherwise, it belongs to the first week of the year
const date3 = Temporal.PlainDate.from("2020-01-01");
console.log(date3.dayOfWeek); // 3
console.log(date3.weekOfYear); // 1
console.log(date3.yearOfWeek); // 2020
// Similarly, if 12-31 is a Monday/Tuesday/Wednesday, it belongs to the first week of the next year
const date4 = Temporal.PlainDate.from("2019-12-31");
console.log(date4.dayOfWeek); // 2
console.log(date4.weekOfYear); // 1
console.log(date4.yearOfWeek); // 2020
Ändern von weekOfYear
PlainDate unterstützt das direkte Ändern von weekOfYear nicht. Um die Woche zu ändern, müssen Sie zuerst den Unterschied in Wochen zu Ihrer gewünschten Woche feststellen und dann add oder subtract verwenden, um das Datum entsprechend anzupassen. Um beispielsweise zur vorherigen Woche zu wechseln:
const date = Temporal.PlainDate.from("2021-07-01");
const previousWeek = date.subtract({ weeks: 1 });
console.log(previousWeek.toString()); // 2021-06-24
Spezifikationen
| Specification |
|---|
| Temporal # sec-get-temporal.plaindate.prototype.weekofyear |