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 weekOfYear Zugriffs-Eigenschaft 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. Es hängt vom Kalender ab.
Beachten Sie, dass gemäß ISO 8601 die ersten und letzten Tage des Jahres der letzten Woche des Vorjahres oder der ersten Woche des nächsten Jahres zugeordnet werden können. Wenn eine Woche zwei Jahre überschreitet, gehört sie zu dem Jahr, das die Mehrheit seiner Tage hat. Um das Jahr zu ermitteln, zu dem die weekOfYear gehört, verwenden Sie die Eigenschaft yearOfWeek, nicht die Eigenschaft year.
Der Set-Zugriffsmodus 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 add() oder subtract() Methode 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 ermitteln und dann add oder subtract verwenden, um das Datum entsprechend anzupassen. Zum Beispiel, um 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 |