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 calendar Accessor-Eigenschaft von Intl.Locale Instanzen gibt den Kalender-Typ für diesen Locale zurück.

In diesem Artikel

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 siehe Intl.supportedValuesOf().

Der Wert der calendar-Eigenschaft wird zur Erstellungszeit festgelegt, entweder durch den ca Schlüssel 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 können 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 hinzugefügt werden.

Hinzufügen eines Kalender-Typs über den Locale-String

In der Unicode Locale-String-Spezifikation ist calendar 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 den Intl.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.

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

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

Der Intl.Locale() Konstruktor hat ein optionales Konfigurationsobjekt-Argument, das mehrere Erweiterungstypen enthalten kann, einschließlich Kalendern. Setzen Sie die calendar-Eigenschaft des Konfigurationsobjekts auf Ihre gewünschte Kalender-Epoche und übergeben Sie sie dann an den Konstruktor.

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

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

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Intl.Locale
Konstruktor
1. Intl.Locale()
Instanzmethoden
1. getCalendars()
2. getCollations()
3. getHourCycles()
4. getNumberingSystems()
5. getTextInfo()
6. getTimeZones()
7. getWeekInfo()
8. maximize()
9. minimize()
10. toString()
Instanzeigenschaften
1. baseName
2. calendar
3. caseFirst
4. collation
5. hourCycle
6. language
7. numberingSystem
8. numeric
9. region
10. script
11. variants
Vererbung
Object/Function
Statische Methoden
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
Statische Eigenschaften
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
Instanzmethoden
1. __defineGetter__()
2. __defineSetter__()
3. __lookupGetter__()
4. __lookupSetter__()
5. hasOwnProperty()
6. isPrototypeOf()
7. propertyIsEnumerable()
8. toLocaleString()
9. toString()
10. valueOf()
Instanzeigenschaften
1. __proto__
2. constructor
Verwandte Seiten
Intl
Intl.Collator
Intl.DateTimeFormat
Intl.DisplayNames
Intl.DurationFormat
Intl.ListFormat
Intl.NumberFormat
Intl.PluralRules
Intl.RelativeTimeFormat
Intl.Segmenter