Intl.Locale.prototype.calendar
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2020 browserübergreifend verfügbar.
Die Accessor-Eigenschaft calendar 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 verschiedene regionale Kalendertypen. Eine Liste der unterstützten Kalendertypen finden Sie unter Intl.supportedValuesOf().
Der Wert der Eigenschaft calendar wird bei der Erstellung festgelegt, entweder über den Schlüssel ca im Gebietsschemabezeichner oder über die Option calendar des Konstruktors Intl.Locale(). Wenn beide angegeben sind, hat die Option Vorrang. Ist keiner von beiden angegeben, hat die Eigenschaft den Wert undefined.
Der Set-Accessor von calendar ist undefined. Sie können diese Eigenschaft nicht direkt ändern.
Beispiele
Wie andere Untertags eines Gebietsschemas kann der Kalendertyp dem Intl.Locale-Objekt entweder über die Gebietsschema-Zeichenfolge oder über ein Konfigurationsobjekt als Argument des Konstruktors hinzugefügt werden.
Einen Kalendertyp über die Gebietsschema-Zeichenfolge hinzufügen
Gemäß der Spezifikation für Unicode-Gebietsschema-Zeichenfolgen ist calendar ein „Erweiterungs-Untertag“. Diese Untertags liefern zusätzliche Informationen über das Gebietsschema und werden Gebietsschemabezeichnern mithilfe des Erweiterungsschlüssels -u hinzugefügt. Um der ursprünglichen Gebietsschema-Zeichenfolge, die an den Konstruktor Intl.Locale() übergeben wird, einen Kalendertyp hinzuzufügen, fügen Sie zunächst den Erweiterungsschlüssel -u hinzu, falls er noch nicht vorhanden ist. Fügen Sie anschließend die Erweiterung -ca hinzu, um anzugeben, dass ein Kalendertyp folgt. Fügen Sie schließlich den Kalendertyp hinzu.
const locale = new Intl.Locale("fr-FR-u-ca-buddhist");
console.log(locale.calendar); // "buddhist"
Einen Kalendertyp über das Konfigurationsobjekt hinzufügen
Der Konstruktor Intl.Locale() akzeptiert optional ein Konfigurationsobjekt als Argument. Dieses kann verschiedene Erweiterungstypen enthalten, darunter Kalendertypen. Setzen Sie die Eigenschaft calendar des Konfigurationsobjekts auf den gewünschten Kalendertyp und übergeben Sie das Objekt anschließend an den Konstruktor.
const locale = new Intl.Locale("fr-FR", { calendar: "buddhist" });
console.log(locale.calendar); // "buddhist"
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Internationalization API Specification> # sec-Intl.Locale.prototype.calendar> |
Browser-Kompatibilität
Siehe auch
Intl.LocaleIntl.Locale.prototype.getCalendars()- Unicode-Kalenderbezeichner in der Spezifikation der Unicode-Gebietsschemadaten-Auszeichnungssprache