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.
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.
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
Intl.Locale
Intl.Locale.prototype.getCalendars()
- Unicode Calendar Identifier in der Unicode Locale Data Markup Language Spezifikation