Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Intl.Locale.prototype.getWeekInfo()

Baseline 2026
Neu verfügbar

Seit Juli 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

Die Methode getWeekInfo() von Intl.Locale-Instanzen gibt Informationen über die Woche für die Locale zurück, beispielsweise den ersten Wochentag und die Wochenendtage.

Hinweis: In einigen Versionen mancher Browser war diese Methode als Accessor-Eigenschaft namens weekInfo implementiert. Da sie jedoch bei jedem Zugriff ein neues Objekt zurückgibt, ist sie jetzt als Methode implementiert. So wird verhindert, dass locale.weekInfo === locale.weekInfo den Wert false zurückgibt. Einzelheiten finden Sie in der Tabelle zur Browser-Kompatibilität.

Syntax

js
getWeekInfo()

Parameter

Keine.

Rückgabewert

Ein Objekt mit Wocheninformationen, die den Locale-Daten gemäß den Week Elements von UTS 35 und den Regionseinstellungen der Locale zugeordnet sind. Es hat die folgenden Eigenschaften:

firstDay

Eine Ganzzahl zwischen 1 (Montag) und 7 (Sonntag), die den ersten Wochentag für die Locale angibt. Häufig ist dies 1, 5, 6 oder 7. Wenn für die Locale bereits ein Wert für firstDayOfWeek festgelegt ist, bezeichnet firstDay denselben Tag als Zahl.

weekend

Ein Array von Ganzzahlen zwischen 1 und 7, das die Wochenendtage für die Locale angibt. Diese Tage liegen normalerweise unmittelbar hintereinander, da UTS 35 stattdessen weekendStart und weekendEnd speichert.

minimalDays

Eine Ganzzahl zwischen 1 und 7 (häufig 1 oder 4), die angibt, wie viele Tage mindestens in der ersten Woche eines Monats oder Jahres liegen müssen, damit diese Woche bei der Berechnung der Kalenderwoche oder der Woche eines Monats als erste Woche zählt (z. B. die 20. Woche des Jahres). Im Kalender nach ISO 8601 muss die erste Woche eines Jahres beispielsweise mindestens 4 Tage dieses Jahres enthalten. Fällt der 1. Januar auf einen Freitag, Samstag oder Sonntag, wird er daher der letzten Woche des Vorjahres zugeordnet.

Hinweis: Diese Eigenschaft wurde aus der Spezifikation entfernt und wird aus Browsern entfernt, da Benutzer im Allgemeinen erwarten, dass unabhängig von der Locale die ISO-Regeln angewendet werden.

Beispiele

Wocheninformationen abrufen

Die Methode getWeekInfo() gibt die Wocheninformationen für eine bestimmte Locale zurück. Beispiele für das explizite Festlegen von firstDayOfWeek finden Sie in den Beispielen zu firstDayOfWeek.

js
const he = new Intl.Locale("he"); // Hebrew (Israel)
console.log(he.getWeekInfo()); // { firstDay: 7, weekend: [5, 6] }

const af = new Intl.Locale("af"); // Afrikaans (South Africa)
console.log(af.getWeekInfo()); // { firstDay: 7, weekend: [6, 7] }

const enGB = new Intl.Locale("en-GB"); // English (United Kingdom)
console.log(enGB.getWeekInfo()); // { firstDay: 1, weekend: [6, 7] }

const arAF = new Intl.Locale("ar-AF"); // Arabic (Afghanistan)
console.log(arAF.getWeekInfo()); // { firstDay: 6, weekend: [4, 5] }

const dvMV = new Intl.Locale("dv-MV"); // Divehi (Maldives)
console.log(dvMV.getWeekInfo()); // { firstDay: 5, weekend: [6, 7] }

Regionale Überschreibungen

Die Erweiterungs-Subtags rg und sd ändern die Regionseinstellungen. Dadurch können andere Wocheninformationen zurückgegeben werden, obwohl der Basisname gleich bleibt.

js
const enUS = new Intl.Locale("en-US");
console.log(enUS.getWeekInfo()); // { firstDay: 7, weekend: [6, 7] }

const enUSInUK = new Intl.Locale("en-US-u-rg-gbzzzz");
console.log(enUSInUK.getWeekInfo()); // { firstDay: 1, weekend: [6, 7] }

const enScot = new Intl.Locale("en-u-sd-gbsct");
console.log(enScot.getWeekInfo()); // { firstDay: 1, weekend: [6, 7] }

Spezifikationen

Spezifikation
Intl Locale Info Proposal
# sec-Intl.Locale.prototype.getWeekInfo

Browser-Kompatibilität

Siehe auch