Diecalendar Accessor-Eigenschaft vonIntl.Locale Instanzen gibt den Kalender-Typ für diesen Locale zurück.

Beschreibung

Obwohl der Großteil der Welt den gregorianischen Kalender verwendet, gibt es weltweit mehrere regionale Kalender-Epochen. Für eine Liste der unterstützten Kalender-Typen sieheIntl.supportedValuesOf().

Der Wert dercalendar-Eigenschaft wird zur Erstellungszeit festgelegt, entweder durch denca Schlüssel des Locale-Identifiers oder durch diecalendar-Option desIntl.Locale() Konstruktors. Letztere hat Vorrang, wenn beide vorhanden sind; und wenn keiner vorhanden ist, hat die Eigenschaft den Wertundefined.

Der Set-Accessor voncalendar istundefined. Sie können diese Eigenschaft nicht direkt ändern.

Beispiele

Wie andere Locale-Subtags kann der Kalender-Typ demIntl.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 derUnicode Locale-String-Spezifikation istcalendar ein "Erweiterungs-Subtag". Diese Subtags fügen zusätzliche Daten über den Locale hinzu und werden zu Locale-Identifikatoren unter Verwendung des-u Erweiterungsschlüssels hinzugefügt. Um den Kalender-Typ zum initialen Locale-Identifier-String hinzuzufügen, der in denIntl.Locale() Konstruktor übergeben wird, fügen Sie zuerst den-u Erweiterungsschlüssel hinzu, falls er nicht existiert. Fügen Sie dann die-ca Erweiterung hinzu, um anzuzeigen, dass Sie einen Kalender-Typ hinzufügen. Schließlich fügen Sie den Kalender-Epochen-Typ hinzu.

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

Hinzufügen eines Kalender-Typs über das Konfigurationsobjekt-Argument

DerIntl.Locale() Konstruktor hat ein optionales Konfigurationsobjekt-Argument, das mehrere Erweiterungstypen enthalten kann, einschließlich Kalendern. Setzen Sie diecalendar-Eigenschaft des Konfigurationsobjekts auf Ihre gewünschte 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-Kompatibilität

Siehe auch

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