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.getCalendars()

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 getCalendars() von Intl.Locale-Instanzen gibt eine Liste mit einem oder mehreren eindeutigen Kalenderkennungen für diese Locale zurück.

Hinweis: In einigen Versionen bestimmter Browser wurde diese Methode als Accessor-Eigenschaft namens calendars implementiert. Da sie jedoch bei jedem Zugriff ein neues Array zurückgibt, ist sie jetzt als Methode implementiert. So wird vermieden, dass locale.calendars === locale.calendars den Wert false zurückgibt. Weitere Informationen finden Sie in der Tabelle zur Browser-Kompatibilität.

Syntax

js
getCalendars()

Parameter

Keine.

Rückgabewert

Ein Array von Strings, das alle für die Locale gemäß ihren Regionseinstellungen gebräuchlichen Kalender angibt, sortiert nach absteigender Präferenz. Wenn für die Locale bereits ein Wert für calendar festgelegt ist, enthält das zurückgegebene Array nur diesen Wert.

Eine Liste der unterstützten Kalendertypen finden Sie unter Intl.supportedValuesOf().

Beispiele

Unterstützte Kalender abrufen

Wenn für das Locale-Objekt noch kein calendar festgelegt ist, listet getCalendars() alle für die angegebene Locale gebräuchlichen Kalender auf. Beispiele für das explizite Festlegen von calendar finden Sie in den Beispielen zu calendar.

js
const arEG = new Intl.Locale("ar-EG");
console.log(arEG.getCalendars()); // ["gregory", "coptic", "islamic", "islamic-civil", "islamic-tbla"]
js
const jaJP = new Intl.Locale("ja-JP");
console.log(jaJP.getCalendars()); // ["gregory", "japanese"]

Regionsüberschreibungen

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

js
const enUS = new Intl.Locale("en-US");
console.log(enUS.getCalendars()); // ["gregory"]

const enUSInJP = new Intl.Locale("en-US-u-rg-jpzzzz");
console.log(enUSInJP.getCalendars()); // ["gregory", "japanese"]

const jaScot = new Intl.Locale("ja-u-sd-gbsct");
console.log(jaScot.getCalendars()); // ["gregory"]

Spezifikationen

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

Browser-Kompatibilität

Siehe auch