Intl.Locale.prototype.calendar

Beschreibung

Obwohl der Groteil der Welt den gregorianischen Kalender verwendet, gibt es weltweit mehrere regionale Kalender-Epochen. Fr eine Liste der untersttzten Kalender-Typen siehe Intl.supportedValuesOf().

Der Wert der calendar-Eigenschaft wird zur Erstellungszeit festgelegt, entweder durch den ca Schlssel 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 knnen 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 hinzugefgt werden.

Hinzufgen eines Kalender-Typs ber den Locale-String

In der Unicode Locale-String-Spezifikation ist calendar ein "Erweiterungs-Subtag". Diese Subtags fgen zustzliche Daten ber den Locale hinzu und werden zu Locale-Identifikatoren unter Verwendung des -u Erweiterungsschlssels hinzugefgt. Um den Kalender-Typ zum initialen Locale-Identifier-String hinzuzufgen, der in den Intl.Locale() Konstruktor bergeben wird, fgen Sie zuerst den -u Erweiterungsschlssel hinzu, falls er nicht existiert. Fgen Sie dann die -ca Erweiterung hinzu, um anzuzeigen, dass Sie einen Kalender-Typ hinzufgen. Schlielich fgen Sie den Kalender-Epochen-Typ hinzu.

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

Hinzufgen eines Kalender-Typs ber das Konfigurationsobjekt-Argument

Der Intl.Locale() Konstruktor hat ein optionales Konfigurationsobjekt-Argument, das mehrere Erweiterungstypen enthalten kann, einschlielich Kalendern. Setzen Sie die calendar-Eigenschaft des Konfigurationsobjekts auf Ihre gewnschte 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

Browser-Kompatibilitt

Siehe auch

• Intl.Locale
• Intl.Locale.prototype.getCalendars()
• Unicode Calendar Identifier in der Unicode Locale Data Markup Language Spezifikation