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.
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.
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
Intl.Locale
Intl.Locale.prototype.getCalendars()
- Unicode Calendar Identifier in der Unicode-Spezifikation für Sprachbereichsdaten-Markup-Sprache