Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Intl.supportedValuesOf()

Baseline
Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2022 browserübergreifend verfügbar.

Die statische Methode Intl.supportedValuesOf() gibt ein Array mit den von der Implementierung unterstützten Werten für Kalender, Sortierungen, Währungen, Zahlensysteme oder Einheiten zurück.

Duplikate werden ausgelassen, und das Array wird in aufsteigender lexikografischer Reihenfolge sortiert (genauer gesagt mit Array.prototype.sort() und einer undefined-Vergleichsfunktion).

Mit der Methode können Sie prüfen, ob bestimmte Werte von einer Implementierung unterstützt werden, und nur bei Bedarf ein Polyfill herunterladen. Sie kann auch verwendet werden, um Benutzeroberflächen zu erstellen, in denen Benutzer ihre bevorzugten lokalisierten Werte auswählen können, etwa wenn die Benutzeroberfläche mit WebGL oder serverseitig erstellt wird.

Diese Methode berücksichtigt keine Locale: Bestimmte Bezeichner werden möglicherweise nur in bestimmten Locales unterstützt oder bevorzugt. Wenn Sie die bevorzugten Werte für eine bestimmte Locale ermitteln möchten, verwenden Sie das Objekt Intl.Locale, beispielsweise Intl.Locale.prototype.getCalendars().

Probieren Sie es aus

console.log(Intl.supportedValuesOf("calendar"));
console.log(Intl.supportedValuesOf("collation"));
console.log(Intl.supportedValuesOf("currency"));
console.log(Intl.supportedValuesOf("numberingSystem"));
console.log(Intl.supportedValuesOf("timeZone"));
console.log(Intl.supportedValuesOf("unit"));
// Expected output: Array ['key'] (for each key)

try {
  Intl.supportedValuesOf("someInvalidKey");
} catch (err) {
  console.log(err.toString());
  // Expected output: RangeError: invalid key: "someInvalidKey"
}

Syntax

js
Intl.supportedValuesOf(key)

Parameter

key

Ein Schlüssel-String, der die Kategorie der zurückzugebenden Werte angibt. Mögliche Werte sind:

Rückgabewert

Ein sortiertes Array eindeutiger String-Werte, das die von der Implementierung für den angegebenen Schlüssel unterstützten Werte enthält. Die möglichen Rückgabewerte sind im Folgenden aufgeführt.

Unterstützte Kalendertypen

Im Folgenden sind alle Werte aufgeführt, die Browser üblicherweise für den Schlüssel calendar unterstützen. Diese Werte können beim Erstellen von Objekten wie Intl.DateTimeFormat für die Option calendar oder den Unicode-Erweiterungsschlüssel ca sowie zum Erstellen von Temporal-Datumsobjekten verwendet werden. Diese Liste ist durch die ECMA-402-Spezifikation ausdrücklich festgelegt, daher sollten sich alle Implementierungen einheitlich verhalten.

Wert Beschreibung
buddhist Thailändischer buddhistischer Kalender, proleptisch. Monatsnummern, Monatscodes und Tage entsprechen denen des ISO-8601-Kalenders, das Epochenjahr ist jedoch anders. Es gibt eine Ära.
chinese Traditioneller chinesischer Kalender, proleptisch. In China verwendeter Lunisolarkalender, der zwischen 1900 und 2100 auf Daten des Purple Mountain Observatory basiert (die zwischen 1912 und 2100 GB/T 33661-2017 entsprechen). Außerhalb dieses Zeitraums wird auf eine von der Implementierung festgelegte Näherung zurückgegriffen. Das arithmetische Jahr entspricht dem von gregory; es gibt keine Ären.
coptic Koptischer Kalender, proleptisch. Ähnlicher solarer Algorithmus wie bei ethioaa und ethiopic, mit einer Ära und einem anderen Epochenjahr.
dangi Traditioneller koreanischer Kalender, proleptisch. Lunisolarkalender, der zwischen 1900 und 2050 die vom Korea Astronomy and Space Science Institute (KASI) veröffentlichten Monate verwendet. Außerhalb dieses Zeitraums wird auf eine von der Implementierung festgelegte Näherung zurückgegriffen. Das arithmetische Jahr entspricht dem von gregory; es gibt keine Ären.
ethioaa Äthiopischer Kalender, Amete Alem, proleptisch. Ähnlicher solarer Algorithmus wie bei coptic und ethiopic, mit einer Ära und einem anderen Epochenjahr.
ethiopic Äthiopischer Kalender, Amete Mihret, proleptisch. Ähnlicher solarer Algorithmus wie bei coptic und ethioaa, mit zwei Ären und einem anderen Epochenjahr.
gregory Gregorianischer Kalender, proleptisch. Solarkalender, der mit dem ISO-8601-Kalender nahezu identisch ist, jedoch keine Wochennummerierung definiert und zwei Ären umfasst, von denen eine vor dem Epochenjahr liegt.
hebrew Hebräischer Kalender, proleptisch. Bürgerlicher Kalender mit Tischri als erstem Monat des Jahres. Lunisolarkalender mit einem Schaltmonat nach dem fünften Monat. Es gibt eine Ära.
indian Indischer Nationalkalender (oder Śaka-Kalender), proleptisch. Solarkalender mit einer Ära.
islamic-civil Hidschri-Kalender, proleptisch, tabellarisch beziehungsweise regelbasiert mit Schaltjahrregel II (Schaltjahre 2, 5, 7, 10, 13, 16, 18, 21, 24, 26 und 29 im 30-Jahres-Zyklus, bei Zählung ab 1) und ziviler Epoche (Freitag, 16. Juli 622 nach dem julianischen Kalender / 0622-07-19 nach ISO).
islamic-tbla Hidschri-Kalender, proleptisch, tabellarisch beziehungsweise regelbasiert mit Schaltjahrregel II (Schaltjahre 2, 5, 7, 10, 13, 16, 18, 21, 24, 26 und 29 im 30-Jahres-Zyklus, bei Zählung ab 1) und astronomischer Epoche (Donnerstag, 15. Juli 622 nach dem julianischen Kalender / 0622-07-18 nach ISO).
islamic-umalqura Hidschri-Kalender, proleptisch, Umm al-Qura. Mondkalender, der vom Beginn des Jahres 1300 AH (1882-11-12 nach ISO) bis zum Ende des Jahres 1600 AH (2174-11-25 nach ISO) die vom KACST berechneten Monate verwendet. Außerhalb dieses Zeitraums wird auf islamic-civil zurückgegriffen.
iso8601 ISO-Kalender (Variante des gregorianischen Kalenders mit regionsunabhängigen Wochenregeln und Formatierungsparametern).
japanese Japanischer Kaiserzeitkalender (dieser Kalender fügt für jeden neuen Kaiser eine Ära hinzu. Daher stimmen bei einem zukünftigen Datum das ausgegebene Jahr und die ausgegebene Ära möglicherweise nicht mit dem eingegebenen Jahr und der eingegebenen Ära überein, wenn Ihr Code auf einer zukünftigen Engine-Version ausgeführt wird. Hinweis: Beachten Sie die Anmerkungen unter dieser Tabelle zu Daten vor dem 1868-10-23 nach ISO).
persian Persischer Kalender (oder Solar-Hidschri-Kalender), proleptisch. Es gibt eine Ära.
roc Kalender der Republik China (oder Minguo-Kalender), proleptisch. Monatsnummern, Monatscodes und Tage entsprechen denen des ISO-8601-Kalenders, das Epochenjahr ist jedoch anders. Es gibt zwei Ären, eine vor und eine nach dem Epochenjahr.

Stand Oktober 2025 funktionieren im Kalender japanese Daten vor dem 1868-10-23 nach ISO (dem Beginn des Jahres 1 Meiji) in Browsern aus zwei Gründen nicht wie erwartet. Erstens enthielt CLDR ein falsches Anfangsdatum für die Meiji-Ära, wodurch Kalenderimplementierungen die Meiji-Ära weiter in die Vergangenheit ausdehnen, als sie tatsächlich zurückreicht. Zweitens legt der bevorstehende Vorschlag zu Ären und monthCode in Intl fest, dass für Daten vor dem 1873-01-01 nach ISO gregorianische Ären verwendet werden sollen. Browser haben stattdessen traditionell Näherungen früherer japanischer Ären verwendet. Der Kalender japanese wurde am 1. Januar des Jahres 6 Meiji / 1873-01-01 nach ISO eingeführt; diese Probleme betreffen daher nur proleptische Daten.

Die folgenden Typen sind in CLDR spezifiziert, haben in Browsern jedoch keine Implementierungen, die sich von den oben genannten Kalendern unterscheiden.

Wert Beschreibung Hinweise
ethiopic-amete-alem Äthiopischer Kalender, Amete Alem, proleptisch. Dies ist ein Alias für ethioaa und wird daher von supportedValuesOf() nicht zurückgegeben. Verwenden Sie stattdessen ethioaa.
islamic Hidschri-Kalender mit nicht festgelegtem Algorithmus. Stand April 2025 handelt es sich um eine astronomische Simulation, deren Parameter nicht dokumentiert sind und von der nicht bekannt ist, dass sie einer bestimmten außerhalb von Software verwendeten Variante des Hidschri-Kalenders entspricht. Laut Spezifikation soll dieser Wert in einen anderen Kalender kanonisiert werden, üblicherweise in islamic-umalqura, islamic-tbla oder islamic-civil, und eine Warnung ausgeben.
islamicc Ziviler (algorithmischer) arabischer Kalender. Dies ist ein Alias für islamic-civil und wird daher von supportedValuesOf() nicht zurückgegeben. Verwenden Sie stattdessen islamic-civil.

Die Dokumentation zu Temporal.PlainDate.prototype.era und Temporal.PlainDate.prototype.monthCode enthält weitere Informationen zu den verschiedenen Kalendern.

Referenzen:

Unterstützte Sortierungstypen

Im Folgenden sind alle Werte aufgeführt, die Browser üblicherweise für den Schlüssel collation unterstützen. Diese Werte können beim Erstellen von Objekten wie Intl.Collator für die Option collation oder den Unicode-Erweiterungsschlüssel co verwendet werden.

Wert Beschreibung
compat Frühere Version der Sortierreihenfolge zur Wahrung der Kompatibilität (für Arabisch).
dict Sortierreihenfolge im Wörterbuchstil (für Singhalesisch). Wird auch als dictionary erkannt.
emoji Empfohlene Sortierreihenfolge für Emoji-Zeichen. Die angeforderte Sprache hat keinen Einfluss. Wird dieser Wert mit einer Sprache kombiniert, für die sprachspezifische Regeln erforderlich sind, funktioniert die Sortierung von Text in dieser Sprache daher nicht richtig!
eor Europäische Sortierregeln (ENV 13710). Diese Sortierreihenfolge ist sprachunabhängig ausgelegt. Obwohl die API verlangt, sie einer Sprache zuzuordnen, hat die angeforderte Sprache keinen Einfluss auf die Reihenfolge.
phonebk Sortierreihenfolge im Telefonbuchstil (für Deutsch). Wird auch als phonebook erkannt.
phonetic Phonetische Sortierreihenfolge (Sortierung nach Aussprache; für Lingála).
pinyin Pinyin-Sortierreihenfolge für lateinische und Han-Zeichen (für Chinesisch).
searchjl Spezieller Sortierungstyp für die Suche nach koreanischen Anfangskonsonanten. Warnung: Diese Sortierung ist nicht zum Sortieren vorgesehen, obwohl sie nur mit Intl.Collator und usage: "sort" verwendet werden kann.
stroke Pinyin-Sortierreihenfolge für lateinische Zeichen, Strichreihenfolge für Han-Zeichen (für Chinesisch).
trad Traditionelle Sortierreihenfolge (beispielsweise für Spanisch). Wird auch als traditional erkannt.
unihan Unihan-Sortierung nach Radikalen und Strichzahl für Han-Zeichen (für Chinesisch, Japanisch und Koreanisch), Pinyin-Sortierung für lateinische Zeichen im Chinesischen und japanische Standard-Kana-Sortierung für Japanisch.
zhuyin Pinyin-Sortierreihenfolge für lateinische Zeichen, Zhuyin-Reihenfolge für Bopomofo- und Han-Zeichen (für Chinesisch).

Die folgenden Typen sind in CLDR-Daten spezifiziert, aber veraltet, für die explizite Verwendung nicht empfohlen und/oder werden von Browsern aus verschiedenen Gründen möglicherweise nicht als unterstützt ausgewiesen. Vermeiden Sie ihre Verwendung:

Wert Beschreibung Hinweise
big5han Pinyin-Sortierreihenfolge für lateinische Zeichen, Reihenfolge des Big5-Zeichensatzes für CJK-Zeichen (für Chinesisch). Veraltet.
direct Binäre Codepunktreihenfolge (für Hindi). Veraltet.
ducet Standardsortierreihenfolge der Unicode Collation Element Table. Der Sortierungstyp ducet ist im Web nicht verfügbar.
gb2312 Pinyin-Sortierreihenfolge für lateinische Zeichen, Reihenfolge des Zeichensatzes gb2312han für CJK-Zeichen (für Chinesisch). Wird auch als gb2312han erkannt. Veraltet.
reformed Reformierte Sortierreihenfolge (beispielsweise für Schwedisch). Veraltet. Dies ist die frühere Bezeichnung für die Standardsortierreihenfolge für Schwedisch, deren Benennung sich früher von der anderer Sprachen unterschied. Da dies die Standardsortierreihenfolge war, fordern Sie sv statt sv-u-co-reformed an.
search Spezieller Sortierungstyp für die String-Suche. Verwenden Sie diesen Wert nicht als Sortierungstyp, da diese Sortierung in Intl.Collator über die Option usage: "search" aktiviert wird. Derzeit gibt es keine API für die Teilstring-Suche; dieser Wert eignet sich daher momentan nur zum Filtern einer Liste von Strings, indem der Suchbegriff mit jedem Listeneintrag als vollständiger String verglichen wird.
standard Standardsortierreihenfolge für jede Sprache außer Chinesisch (und früher Schwedisch). Nicht explizit verwenden. Im Allgemeinen ist die explizite Angabe unnötig; für Schwedisch ist sie zudem problematisch, da der Wert dort früher eine andere Bedeutung hatte.

Referenzen:

Unterstützte Währungsbezeichner

Währungsbezeichner sind dreibuchstabige Großbuchstabencodes, die in ISO 4217 definiert sind. Diese Werte können beim Erstellen von Objekten wie Intl.NumberFormat für die Option currency sowie für Intl.DisplayNames.prototype.of() verwendet werden. Es gibt mehr als 300 gebräuchliche Bezeichner, daher werden sie hier nicht aufgeführt. Eine vollständige Liste möglicher Bezeichner finden Sie im Wikipedia-Artikel.

Referenzen:

Unterstützte Zahlensystemtypen

Im Folgenden sind alle Werte aufgeführt, die Browser üblicherweise für den Schlüssel numberingSystem unterstützen. Diese Werte können beim Erstellen von Objekten wie Intl.NumberFormat für die Option numberingSystem oder den Unicode-Erweiterungsschlüssel nu verwendet werden. Bei den Zeilen mit Ziffernzeichen setzt die Laufzeitumgebung die Ziffern einzeln um, ohne weitere Verarbeitungsschritte. Die anderen, als „algorithmisch“ gekennzeichneten Systeme benötigen zusätzliche Algorithmen für die Umsetzung. Je höher der Unicode-Codepunkt ist, desto neuer ist das Zahlensystem und desto wahrscheinlicher ist es, dass es nicht von allen Browsern unterstützt wird.

Wert Beschreibung Ziffernzeichen
adlm Adlam-Ziffern 𞥐𞥑𞥒𞥓𞥔𞥕𞥖𞥗𞥘𞥙 (U+1E950 bis U+1E959)
ahom Ahom-Ziffern 𑜰𑜱𑜲𑜳𑜴𑜵𑜶𑜷𑜸𑜹 (U+11730 bis U+11739)
arab Arabisch-indische Ziffern ٠١٢٣٤٥٦٧٨٩ (U+0660 bis U+0669)
arabext Erweiterte arabisch-indische Ziffern ۰۱۲۳۴۵۶۷۸۹ (U+06F0 bis U+06F9)
armn Armenische Großbuchstaben-Zahlzeichen algorithmisch
armnlow Armenische Kleinbuchstaben-Zahlzeichen algorithmisch
bali Balinesische Ziffern ᭐᭑᭒᭓᭔᭕᭖᭗᭘᭙ (U+1B50 bis U+1B59)
beng Bengalische Ziffern ০১২৩৪৫৬৭৮৯ (U+09E6 bis U+09EF)
bhks Bhaiksuki-Ziffern 𑱐𑱑𑱒𑱓𑱔𑱕𑱖𑱗𑱘𑱙 (U+11C50 bis U+11C59)
brah Brahmi-Ziffern 𑁦𑁧𑁨𑁩𑁪𑁫𑁬𑁭𑁮𑁯 (U+11066 bis U+1106F)
cakm Chakma-Ziffern 𑄶𑄷𑄸𑄹𑄺𑄻𑄼𑄽𑄾𑄿 (U+11136 bis U+1113F)
cham Cham-Ziffern ꩐꩑꩒꩓꩔꩕꩖꩗꩘꩙ (U+AA50 bis U+AA59)
cyrl Kyrillische Zahlzeichen algorithmisch
deva Devanagari-Ziffern ०१२३४५६७८९ (U+0966 bis U+096F)
diak Dives-Akuru-Ziffern 𑥐𑥑𑥒𑥓𑥔𑥕𑥖𑥗𑥘𑥙 (U+11950 bis U+11959)
ethi Äthiopische Zahlzeichen algorithmisch
fullwide Vollbreite Ziffern 0123456789 (U+FF10 bis U+FF19)
gara Garay-Ziffern 𐵀𐵁𐵂𐵃𐵄𐵅𐵆𐵇𐵈𐵉 (U+10D40 bis U+10D49)
geor Georgische Zahlzeichen algorithmisch
gong Gunjala-Gondi-Ziffern 𑶠𑶡𑶢𑶣𑶤𑶥𑶦𑶧𑶨𑶩 (U+11DA0 bis U+11DA9)
gonm Masaram-Gondi-Ziffern 𑵐𑵑𑵒𑵓𑵔𑵕𑵖𑵗𑵘𑵙 (U+11D50 bis U+11D59)
grek Griechische Großbuchstaben-Zahlzeichen algorithmisch
greklow Griechische Kleinbuchstaben-Zahlzeichen algorithmisch
gujr Gujarati-Ziffern ૦૧૨૩૪૫૬૭૮૯ (U+0AE6 bis U+0AEF)
gukh Gurung-Khema-Ziffern 𖄰𖄱𖄲𖄳𖄴𖄵𖄶𖄷𖄸𖄹 (U+16130 bis U+16139)
guru Gurmukhi-Ziffern ੦੧੨੩੪੫੬੭੮੯ (U+0A66 bis U+0A6F)
hanidays Nummerierung der Monatstage mit Han-Zeichen für Mondkalender und andere traditionelle Kalender
hanidec Stellenwertbasiertes Dezimalsystem mit chinesischen Zahlzeichen als Ziffern 〇一二三四五六七八九 (U+3007, U+4E00, U+4E8C, U+4E09, U+56DB, U+4E94, U+516D, U+4E03, U+516B, U+4E5D)
hans Vereinfachte chinesische Zahlzeichen algorithmisch
hansfin Vereinfachte chinesische Finanzzahlzeichen algorithmisch
hant Traditionelle chinesische Zahlzeichen algorithmisch
hantfin Traditionelle chinesische Finanzzahlzeichen algorithmisch
hebr Hebräische Zahlzeichen algorithmisch
hmng Pahawh-Hmong-Ziffern 𖭐𖭑𖭒𖭓𖭔𖭕𖭖𖭗𖭘𖭙 (U+16B50 bis U+16B59)
hmnp Nyiakeng-Puachue-Hmong-Ziffern 𞅀𞅁𞅂𞅃𞅄𞅅𞅆𞅇𞅈𞅉 (U+1E140 bis U+1E149)
java Javanische Ziffern ꧐꧑꧒꧓꧔꧕꧖꧗꧘꧙ (U+A9D0 bis U+A9D9)
jpan Japanische Zahlzeichen algorithmisch
jpanfin Japanische Finanzzahlzeichen algorithmisch
jpanyear Japanische Gannen-Nummerierung für das erste Jahr einer Ära im japanischen Kalender algorithmisch
kali Kayah-Li-Ziffern ꤀꤁꤂꤃꤄꤅꤆꤇꤈꤉ (U+A900 bis U+A909)
kawi Kawi-Ziffern 𑽐𑽑𑽒𑽓𑽔𑽕𑽖𑽗𑽘𑽙 (U+11F50 bis U+11F59)
khmr Khmer-Ziffern ០១២៣៤៥៦៧៨៩ (U+17E0 bis U+17E9)
knda Kannada-Ziffern ೦೧೨೩೪೫೬೭೮೯ (U+0CE6 bis U+0CEF)
krai Kirat-Rai-Ziffern 𖵰𖵱𖵲𖵳𖵴𖵵𖵶𖵷𖵸𖵹 (U+16D70 bis U+16D79)
lana Weltliche Tai-Tham-Hora-Ziffern ᪀᪁᪂᪃᪄᪅᪆᪇᪈᪉ (U+1A80 bis U+1A89)
lanatham Religiöse Tai-Tham-Ziffern ᪐᪑᪒᪓᪔᪕᪖᪗᪘᪙ (U+1A90 bis U+1A99)
laoo Laotische Ziffern ໐໑໒໓໔໕໖໗໘໙ (U+0ED0 bis U+0ED9)
latn Lateinische Ziffern 0123456789 (U+0030 bis U+0039)
lepc Lepcha-Ziffern ᱀᱁᱂᱃᱄᱅᱆᱇᱈᱉ (U+1C40 bis U+1C49)
limb Limbu-Ziffern ᥆᥇᥈᥉᥊᥋᥌᥍᥎᥏ (U+1946 bis U+194F)
mathbold Mathematische fette Ziffern 𝟎𝟏𝟐𝟑𝟒𝟓𝟔𝟕𝟖𝟗 (U+1D7CE bis U+1D7D7)
mathdbl Mathematische doppelstrichige Ziffern 𝟘𝟙𝟚𝟛𝟜𝟝𝟞𝟟𝟠𝟡 (U+1D7D8 bis U+1D7E1)
mathmono Mathematische nichtproportionale Ziffern 𝟶𝟷𝟸𝟹𝟺𝟻𝟼𝟽𝟾𝟿 (U+1D7F6 bis U+1D7FF)
mathsanb Mathematische fette serifenlose Ziffern 𝟬𝟭𝟮𝟯𝟰𝟱𝟲𝟳𝟴𝟵 (U+1D7EC bis U+1D7F5)
mathsans Mathematische serifenlose Ziffern 𝟢𝟣𝟤𝟥𝟦𝟧𝟨𝟩𝟪𝟫 (U+1D7E2 bis U+1D7EB)
mlym Malayalam-Ziffern ൦൧൨൩൪൫൬൭൮൯ (U+0D66 bis U+0D6F)
modi Modi-Ziffern 𑙐𑙑𑙒𑙓𑙔𑙕𑙖𑙗𑙘𑙙 (U+11650 bis U+11659)
mong Mongolische Ziffern ᠐᠑᠒᠓᠔᠕᠖᠗᠘᠙ (U+1810 bis U+1819)
mroo Mro-Ziffern 𖩠𖩡𖩢𖩣𖩤𖩥𖩦𖩧𖩨𖩩 (U+16A60 bis U+16A69)
mtei Meetei-Mayek-Ziffern ꯰꯱꯲꯳꯴꯵꯶꯷꯸꯹ (U+ABF0 bis U+ABF9)
mymr Myanmar-Ziffern ၀၁၂၃၄၅၆၇၈၉ (U+1040 bis U+1049)
mymrepka Ost-Pwo-Karen-Ziffern aus Myanmar 𑛚𑛛𑛜𑛝𑛞𑛟𑛠𑛡𑛢𑛣 (U+116DA bis U+116E3)
mymrpao Pa-O-Ziffern aus Myanmar 𑛐𑛑𑛒𑛓𑛔𑛕𑛖𑛗𑛘𑛙 (U+116D0 bis U+116D9)
mymrshan Shan-Ziffern aus Myanmar ႐႑႒႓႔႕႖႗႘႙ (U+1090 bis U+1099)
mymrtlng Tai-Laing-Ziffern aus Myanmar ꧰꧱꧲꧳꧴꧵꧶꧷꧸꧹ (U+A9F0 bis U+A9F9)
nagm Nag-Mundari-Ziffern 𞓰𞓱𞓲𞓳𞓴𞓵𞓶𞓷𞓸𞓹 (U+1E4F0 bis U+1E4F9)
newa Newa-Ziffern 𑑐𑑑𑑒𑑓𑑔𑑕𑑖𑑗𑑘𑑙 (U+11450 bis U+11459)
nkoo N’Ko-Ziffern ߀߁߂߃߄߅߆߇߈߉ (U+07C0 bis U+07C9)
olck Ol-Chiki-Ziffern ᱐᱑᱒᱓᱔᱕᱖᱗᱘᱙ (U+1C50 bis U+1C59)
onao Ol-Onal-Ziffern 𞗱𞗲𞗳𞗴𞗵𞗶𞗷𞗸𞗹𞗺 (U+1E5F1 bis U+1E5FA)
orya Oriya-Ziffern ୦୧୨୩୪୫୬୭୮୯ (U+0B66 bis U+0B6F)
osma Osmanya-Ziffern 𐒠𐒡𐒢𐒣𐒤𐒥𐒦𐒧𐒨𐒩 (U+104A0 bis U+104A9)
outlined Umrissziffern aus älteren Computersystemen 𜳰𜳱𜳲𜳳𜳴𜳵𜳶𜳷𜳸𜳹 (U+1CCF0 bis U+1CCF9)
rohg Hanifi-Rohingya-Ziffern 𐴰𐴱𐴲𐴳𐴴𐴵𐴶𐴷𐴸𐴹 (U+10D30 bis U+10D39)
roman Römische Großbuchstaben-Zahlzeichen algorithmisch
romanlow Römische Kleinbuchstaben-Zahlzeichen algorithmisch
saur Saurashtra-Ziffern ꣐꣑꣒꣓꣔꣕꣖꣗꣘꣙ (U+A8D0 bis U+A8D9)
segment Segmentierte Ziffern aus älteren Computersystemen 🯰🯱🯲🯳🯴🯵🯶🯷🯸🯹 (U+1FBF0 bis U+1FBF9)
shrd Sharada-Ziffern 𑇐𑇑𑇒𑇓𑇔𑇕𑇖𑇗𑇘𑇙 (U+111D0 bis U+111D9)
sind Khudawadi-Ziffern 𑋰𑋱𑋲𑋳𑋴𑋵𑋶𑋷𑋸𑋹 (U+112F0 bis U+112F9)
sinh Sinhala-Lith-Ziffern ෦෧෨෩෪෫෬෭෮෯ (U+0DE6 bis U+0DEF)
sora Sora-Sompeng-Ziffern 𑃰𑃱𑃲𑃳𑃴𑃵𑃶𑃷𑃸𑃹 (U+110F0 bis U+110F9)
sund Sundanesische Ziffern ᮰᮱᮲᮳᮴᮵᮶᮷᮸᮹ (U+1BB0 bis U+1BB9)
sunu Sunuwar-Ziffern 𑯰𑯱𑯲𑯳𑯴𑯵𑯶𑯷𑯸𑯹 (U+11BF0 bis U+11BF9)
takr Takri-Ziffern 𑛀𑛁𑛂𑛃𑛄𑛅𑛆𑛇𑛈𑛉 (U+116C0 bis U+116C9)
talu Neu-Tai-Lue-Ziffern ᧐᧑᧒᧓᧔᧕᧖᧗᧘᧙ (U+19D0 bis U+19D9)
taml Tamilische Zahlzeichen algorithmisch
tamldec Moderne tamilische Dezimalziffern ௦௧௨௩௪௫௬௭௮௯ (U+0BE6 bis U+0BEF)
telu Telugu-Ziffern ౦౧౨౩౪౫౬౭౮౯ (U+0C66 bis U+0C6F)
thai Thailändische Ziffern ๐๑๒๓๔๕๖๗๘๙ (U+0E50 bis U+0E59)
tibt Tibetische Ziffern ༠༡༢༣༤༥༦༧༨༩ (U+0F20 bis U+0F29)
tirh Tirhuta-Ziffern 𑓐𑓑𑓒𑓓𑓔𑓕𑓖𑓗𑓘𑓙 (U+114D0 bis U+114D9)
tnsa Tangsa-Ziffern 𖫀𖫁𖫂𖫃𖫄𖫅𖫆𖫇𖫈𖫉 (U+16AC0 bis U+16AC9)
tols Tolong-Siki-Ziffern 𑷠𑷡𑷢𑷣𑷤𑷥𑷦𑷧𑷨𑷩 (U+11DE0 bis U+11DE9)
vaii Vai-Ziffern ꘠꘡꘢꘣꘤꘥꘦꘧꘨꘩ (U+A620 bis U+A629)
wara Warang-Citi-Ziffern 𑣠𑣡𑣢𑣣𑣤𑣥𑣦𑣧𑣨𑣩 (U+118E0 bis U+118E9)
wcho Wancho-Ziffern 𞋰𞋱𞋲𞋳𞋴𞋵𞋶𞋷𞋸𞋹 (U+1E2F0 bis U+1E2F9)

Es gibt drei besondere Werte: native, traditio und finance. Ihre Bedeutung hängt von der Locale ab, und sie werden entsprechend der Locale in das passende System aufgelöst. Daher geben die resolvedOptions()-Methoden diese Werte nie zurück; Intl.Locale.prototype.numberingSystem kann sie jedoch zurückgeben, wenn sie als Eingabe angegeben wurden.

Referenzen:

Unterstützte Zeitzonenbezeichner

Unterstützte Zeitzonenbezeichner können beim Erstellen von Objekten wie Intl.DateTimeFormat für die Option timeZone sowie zum Erstellen von Temporal-Datumsobjekten verwendet werden. Es gibt mehr als 400 gebräuchliche Bezeichner, daher werden sie hier nicht aufgeführt. Eine vollständige Liste möglicher Bezeichner finden Sie im Wikipedia-Artikel oder in der IANA-Zeitzonendatenbank.

Beachten Sie beim Durchsehen der Liste, dass die Standardisierung von Temporal Browser dazu verpflichtet, stets den primären Bezeichner aus der IANA-Datenbank zurückzugeben. Dieser kann sich im Laufe der Zeit ändern. Weitere Informationen finden Sie unter Zeitzonen und Offsets. Beispielsweise sollte das zurückgegebene Array "Asia/Kolkata" statt "Asia/Calcutta" enthalten, da Letzteres ein Alias für Ersteres ist und beide Indien zugeordnet sind. Dagegen sollte es sowohl "Africa/Abidjan" als auch "Atlantic/Reykjavik" enthalten, weil sie verschiedenen Ländern zugeordnet sind, obwohl Letzteres ebenfalls ein Alias für Ersteres ist.

Referenzen:

Unterstützte Einheitenbezeichner

Im Folgenden sind alle Werte aufgeführt, die Browser üblicherweise für den Schlüssel unit unterstützen. Diese Werte können beim Erstellen von Objekten wie Intl.NumberFormat für die Option unit verwendet werden. Diese Liste ist eine Teilmenge der CLDR-Einheiten, die durch die ECMA-402-Spezifikation ausdrücklich zugelassen ist. Daher sollten sich alle Implementierungen einheitlich verhalten.

  • acre
  • bit
  • byte
  • celsius
  • centimeter
  • day
  • degree
  • fahrenheit
  • fluid-ounce
  • foot
  • gallon
  • gigabit
  • gigabyte
  • gram
  • hectare
  • hour
  • inch
  • kilobit
  • kilobyte
  • kilogram
  • kilometer
  • liter
  • megabit
  • megabyte
  • meter
  • microsecond
  • mile
  • mile-scandinavian
  • milliliter
  • millimeter
  • millisecond
  • minute
  • month
  • nanosecond
  • ounce
  • percent
  • petabyte
  • pound
  • second
  • stone
  • terabit
  • terabyte
  • week
  • yard
  • year

Bei der Angabe von Einheiten können Sie auch zwei Einheiten mit dem Trennzeichen „-per-“ kombinieren, beispielsweise meter-per-second oder liter-per-megabyte.

Referenzen:

Ausnahmen

RangeError

Wird ausgelöst, wenn ein nicht unterstützter Schlüssel als Parameter übergeben wird.

Beispiele

Unterstützung prüfen

Sie können prüfen, ob die Methode unterstützt wird, indem Sie sie mit undefined vergleichen:

js
if (typeof Intl.supportedValuesOf !== "undefined") {
  // method is supported
}

Alle Werte für einen Schlüssel abrufen

Um die unterstützten Kalenderwerte abzurufen, rufen Sie die Methode mit dem Schlüssel "calendar" auf. Anschließend können Sie wie unten gezeigt über das zurückgegebene Array iterieren:

js
Intl.supportedValuesOf("calendar").forEach((calendar) => {
  // "buddhist", "chinese", "coptic", "dangi", etc.
});

Alle anderen Werte werden auf dieselbe Weise abgerufen:

js
Intl.supportedValuesOf("collation").forEach((collation) => {
  // "compat", "dict", "emoji", etc.
});

Intl.supportedValuesOf("currency").forEach((currency) => {
  // "ADP", "AED", "AFA", "AFN", "ALK", "ALL", "AMD", etc.
});

Intl.supportedValuesOf("numberingSystem").forEach((numberingSystem) => {
  // "adlm", "ahom", "arab", "arabext", "bali", etc.
});

Intl.supportedValuesOf("timeZone").forEach((timeZone) => {
  // "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", etc.
});

Intl.supportedValuesOf("unit").forEach((unit) => {
  // "acre", "bit", "byte", "celsius", "centimeter", etc.
});

Ungültiger Schlüssel löst RangeError aus

js
try {
  Intl.supportedValuesOf("someInvalidKey");
} catch (err) {
  // RangeError: invalid key: "someInvalidKey"
}

Spezifikationen

Spezifikation
ECMAScript® 2027 Internationalization API Specification
# sec-intl.supportedvaluesof

Browser-Kompatibilität

Siehe auch