Intl.Locale.prototype.calendar

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.

Die calendar Zugriffs-Eigenschaft von Intl.Locale Instanzen gibt den Kalender-Typ für diese Locale zurück.

Beschreibung

Während der größte Teil der Welt den gregorianischen Kalender verwendet, gibt es weltweit mehrere regionale Kalender-Epochen. Der Wert der calendar-Eigenschaft wird zur Zeit der Konstruktion entweder durch den ca-Schlüssel des Locale-Bezeichners oder durch die calendar-Option des Intl.Locale()-Konstruktors festgelegt. Letztere hat Vorrang, wenn beide vorhanden sind; und wenn keine von beiden vorhanden ist, hat die Eigenschaft den Wert undefined.

Für eine Liste der unterstützten Kalender-Typen siehe Intl.supportedValuesOf().

Der Set-Zugriff von calendar ist undefined. Sie können diese Eigenschaft nicht direkt ändern.

Beispiele

Wie andere Locale-Subtags kann der Kalender-Typ zum Intl.Locale-Objekt über den Locale-String oder ein Konfigurationsobjekt-Argument des Konstruktors hinzugefügt werden.

Hinzufügen eines Kalender-Typs über den Locale-String

In der Unicode-Locale-String-Spezifikation sind Kalender-Epochen-Typen Locale-Schlüssel-„Erweiterungs-Subtags“. Diese Subtags fügen zusätzliche Daten zur Locale hinzu und werden zu Locale-Bezeichnern hinzugefügt, indem die -u-Erweiterung verwendet wird. So kann der Kalender-Epochen-Typ zum ursprünglichen Locale-Bezeichner-String hinzugefügt werden, der in den Intl.Locale()-Konstruktor übergeben wird. Um den Kalender-Typ hinzuzufügen, fügen Sie zuerst die -u-Erweiterung zum String hinzu. Fügen Sie anschließend die -ca-Erweiterung hinzu, um anzugeben, dass Sie einen Kalender-Typ hinzufügen. Schließlich fügen Sie den Kalender-Epochen-Typ zum String hinzu.

js
const locale = new Intl.Locale("fr-FR-u-ca-buddhist");
console.log(locale.calendar); // Prints "buddhist"

Hinzufügen eines Kalender-Typs über das Konfigurationsobjekt-Argument

Der Intl.Locale()-Konstruktor hat ein optionales Konfigurationsobjekt-Argument, das eine der mehreren Erweiterungsarten, einschließlich Kalender, enthalten kann. Setzen Sie die calendar-Eigenschaft des Konfigurationsobjekts auf die gewünschte Kalender-Epoche und übergeben Sie sie dann in den Konstruktor.

js
const locale = new Intl.Locale("fr-FR", { calendar: "buddhist" });
console.log(locale.calendar); // "buddhist"

Spezifikationen

Specification
ECMAScript® 2025 Internationalization API Specification
# sec-Intl.Locale.prototype.calendar

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
calendar

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch