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

Hinweis: In einigen Versionen einiger Browser wurde diese Methode als Zugriffs-Eigenschaft namens calendars implementiert. Da sie jedoch bei jedem Zugriff ein neues Array zurückgibt, wird sie nun als Methode implementiert, um 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 Zeichenketten, 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

Erhalten unterstützter Kalender

Wenn das Locale-Objekt nicht bereits einen calendar hat, listet getCalendars() alle üblicherweise verwendeten Kalender für das gegebene Locale auf. Für Beispiele, wie ein calendar explizit gesetzt wird, 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

BCD tables only load in the browser

Siehe auch