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 Kalendertyp für dieses Gebietsschema zurück.

Beschreibung

Obwohl der Großteil der Welt den gregorianischen Kalender verwendet, gibt es weltweit mehrere regionale Kalenderzeitalter. Der Wert der calendar-Eigenschaft wird zur Konstruktion festgelegt, entweder über den ca-Schlüssel des Gebietsschema-Identifiers oder über die calendar-Option des Intl.Locale()-Konstruktors. Letzteres hat Vorrang, wenn beide vorhanden sind; und wenn keines vorhanden ist, hat die Eigenschaft den Wert undefined.

Für eine Liste der unterstützten Kalendertypen siehe Intl.Locale.prototype.getCalendars().

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

Beispiele

Wie andere Sprachgebietsschema-Untertags kann der Kalendertyp dem Intl.Locale-Objekt über den Sprachstring oder ein Konfigurationsobjekt als Argument des Konstruktors hinzugefügt werden.

Hinzufügen eines Kalendertyps über den Sprachstring

In der Unicode-Spezifikation für Sprachstrings sind Kalendertypen als "Erweiterungs-Untertags" des Sprachschlüssels angegeben. Diese Untertags fügen zusätzliche Daten über das Gebietsschema hinzu und werden zu Sprachenthält durch die Verwendung der -u-Erweiterung hinzugefügt. So kann der Kalendertyp zum ersten Gebietsschema-Identifier-String, der in den Intl.Locale()-Konstruktor übergeben wird, hinzugefügt werden. Um den Kalendertyp hinzuzufügen, fügen Sie zunächst die -u-Erweiterung zum String hinzu. Fügen Sie dann die -ca-Erweiterung hinzu, um anzugeben, dass Sie einen Kalendertyp hinzufügen. Schließlich fügen Sie den Kalendertyp zur Zeitalter zum String hinzu.

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

Hinzufügen eines Kalendertyps über das Konfigurationsobjekt-Argument

Der Intl.Locale()-Konstruktor verfügt über ein optionales Konfigurationsobjekt-Argument, das verschiedene Erweiterungstypen, einschließlich Kalender, enthalten kann. Setzen Sie die calendar-Eigenschaft des Konfigurationsobjekts auf Ihr gewünschtes Kalenderzeitalter und übergeben Sie es dann an den Konstruktor.

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch