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

BCD tables only load in the browser

Siehe auch