Intl.Locale.prototype.getCalendars()

Limited availability

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

Die getCalendars() Methode von Intl.Locale Instanzen gibt eine Liste von einem oder mehreren einzigartigen Kalenderkennungen für diese Locale zurück.

Hinweis: In einigen Versionen von einigen Browsern wurde diese Methode als Accessor-Eigenschaft mit dem Namen calendars implementiert. Da sie jedoch bei jedem Zugriff ein neues Array zurückgibt, ist sie jetzt als Methode implementiert, um die Situation zu verhindern, dass locale.calendars === locale.calendars false zurückgibt. Überprüfen Sie die Browser-Kompatibilitätstabelle für Details.

Syntax

js
getCalendars()

Parameter

Keine.

Rückgabewert

Ein Array von Zeichenfolgen, das alle Kalender darstellt, die üblicherweise für die Locale verwendet werden, sortiert in absteigender Präferenz. Wenn die Locale bereits einen calendar hat, enthält das zurückgegebene Array diesen einzelnen Wert.

Für eine Liste der unterstützten Kalendertypen, siehe Intl.supportedValuesOf().

Beispiele

Erhalt von unterstützten Kalendern

Wenn das Locale Objekt noch keinen calendar hat, listet getCalendars() alle üblicherweise verwendeten Kalender für die gegebene Locale auf. Für Beispiele zum expliziten Setzen eines calendar, siehe calendar Beispiele.

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"]

Spezifikationen

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

Browser-Kompatibilität

Siehe auch