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 Accessor-Eigenschaft von Intl.Locale Instanzen gibt den Kalender-Typ für diesen Locale zurück.

Beschreibung

Obwohl der Großteil der Welt den gregorianischen Kalender verwendet, gibt es weltweit mehrere regionale Kalender-Epochen. Für eine Liste der unterstützten Kalender-Typen siehe Intl.supportedValuesOf().

Der Wert der calendar-Eigenschaft wird zur Erstellungszeit festgelegt, entweder durch den ca Schlüssel des Locale-Identifiers oder durch die calendar-Option des Intl.Locale() Konstruktors. Letztere hat Vorrang, wenn beide vorhanden sind; und wenn keiner vorhanden ist, hat die Eigenschaft den Wert undefined.

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

Beispiele

Wie andere Locale-Subtags kann der Kalender-Typ dem 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 ist calendar ein "Erweiterungs-Subtag". Diese Subtags fügen zusätzliche Daten über den Locale hinzu und werden zu Locale-Identifikatoren unter Verwendung des -u Erweiterungsschlüssels hinzugefügt. Um den Kalender-Typ zum initialen Locale-Identifier-String hinzuzufügen, der in den Intl.Locale() Konstruktor übergeben wird, fügen Sie zuerst den -u Erweiterungsschlüssel hinzu, falls er nicht existiert. Fügen Sie dann die -ca Erweiterung hinzu, um anzuzeigen, dass Sie einen Kalender-Typ hinzufügen. Schließlich fügen Sie den Kalender-Epochen-Typ hinzu.

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

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

Der Intl.Locale() Konstruktor hat ein optionales Konfigurationsobjekt-Argument, das mehrere Erweiterungstypen enthalten kann, einschließlich Kalendern. Setzen Sie die calendar-Eigenschaft des Konfigurationsobjekts auf Ihre gewünschte Kalender-Epoche und übergeben Sie sie dann an den Konstruktor.

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

Spezifikationen

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

Browser-Kompatibilität

Siehe auch