Intl.supportedValuesOf()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.
Die statische Methode Intl.supportedValuesOf()
gibt ein Array zurück, das die von der Implementierung unterstützten Kalender-, Kollations-, Währungs-, Nummerierungs- oder Einheit-Werte enthält.
Doppelte Einträge werden weggelassen, und das Array wird in aufsteigender lexikografischer Reihenfolge sortiert (genauer gesagt, indem Array.prototype.sort()
mit einer undefinierten Vergleichsfunktion verwendet wird).
Die Methode kann verwendet werden, um zu testen, ob bestimmte Werte in einer bestimmten Implementierung unterstützt werden, und um ein Polyfill nur bei Bedarf herunterzuladen. Sie kann auch genutzt werden, um Benutzeroberflächen zu erstellen, die es Nutzern ermöglichen, ihre bevorzugten lokalisierten Werte auszuwählen, zum Beispiel wenn die Benutzeroberfläche aus WebGL oder serverseitig erstellt wird.
Diese Methode ist nicht lokalisierungsabhängig: Es ist möglich, dass bestimmte Identifikatoren nur in bestimmten Regionen unterstützt oder bevorzugt werden. Wenn Sie die bevorzugten Werte für eine bestimmte Region ermitteln möchten, sollten Sie das Objekt Intl.Locale
verwenden, wie zum Beispiel 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
Intl.supportedValuesOf(key)
Parameter
key
-
Ein Schlüsselstring, der die Kategorie der zurückzugebenden Werte angibt. Dies sind:
"calendar"
: siehe unterstützte Kalendertypen"collation"
: siehe unterstützte Kollationstypen"currency"
: siehe unterstützte Währungs-Identifikatoren"numberingSystem"
: siehe unterstützte Nummerierungssystemtypen"timeZone"
: siehe unterstützte Zeitzonen-Identifikatoren"unit"
: siehe unterstützte Einheiten-Identifikatoren
Rückgabewert
Ein sortiertes Array von eindeutigen Zeichenfolgenwerten, die die unterstützten Werte der Implementierung für den angegebenen Schlüssel anzeigen. Die unten aufgeführten Werte könnten zurückgegeben werden.
Unterstützte Kalendertypen
Nachfolgend sind alle Werte aufgeführt, die für den Schlüssel calendar
üblicherweise von Browsern unterstützt werden. Diese Werte können für die calendar
-Option oder den ca
- Unicode-Erweiterungsschlüssel verwendet werden, wenn Objekte wie Intl.DateTimeFormat
erstellt werden, sowie für die Erstellung von Temporal
-Datumsobjekten.
Wert | Beschreibung |
---|---|
buddhist |
Thailändischer buddhistischer Kalender |
chinese |
Traditioneller chinesischer Kalender |
coptic |
Koptischer Kalender |
dangi |
Traditioneller koreanischer Kalender |
ethioaa |
Äthiopischer Kalender, Amete Alem (Epoche ca. 5493 v. Chr.) |
ethiopic |
Äthiopischer Kalender, Amete Mihret (Epoche ca. 8 n. Chr.) |
gregory |
Gregorianischer Kalender |
hebrew |
Traditioneller hebräischer Kalender |
indian |
Indischer Kalender |
islamic |
Hijri-Kalender |
islamic-umalqura |
Hijri-Kalender, Umm al-Qura |
islamic-tbla |
Hijri-Kalender, tabellarisch (Schaltjahre [2,5,7,10,13,16,18,21,24,26,29] - astronomische Epoche) |
islamic-civil |
Hijri-Kalender, tabellarisch (Schaltjahre [2,5,7,10,13,16,18,21,24,26,29] - zivile Epoche) |
islamic-rgsa |
Hijri-Kalender, Sichtung in Saudi-Arabien |
iso8601 |
ISO-Kalender (Gregorianischer Kalender mit ISO-8601-Kalenderwoche-Regeln) |
japanese |
Japanischer imperiale Kalender |
persian |
Persischer Kalender |
roc |
Kalender der Republik China |
Die unten stehenden Typen sind in den CLDR-Daten angegeben, werden jedoch als veraltet eingestuft, von einer expliziten Nutzung abgeraten und/oder können aus verschiedenen Gründen von Browsern als nicht unterstützt angezeigt werden. Vermeiden Sie deren Nutzung:
Wert | Beschreibung | Anmerkungen |
---|---|---|
islamicc
Veraltet
|
Ziviler (algorithmischer) arabischer Kalender. | Dies ist ein Alias für islamic-civil und wird daher nicht von supportedValuesOf() zurückgegeben. Verwenden Sie stattdessen islamic-civil . |
Referenzen:
Unterstützte Kollationstypen
Nachfolgend sind alle Werte aufgeführt, die für den Schlüssel collation
üblicherweise von Browsern unterstützt werden. Diese Werte können für die collation
-Option oder den co
- Unicode-Erweiterungsschlüssel verwendet werden, wenn Objekte wie Intl.Collator
erstellt werden.
Wert | Beschreibung |
---|---|
compat |
Eine vorherige Version der Sortierung, zur Kompatibilität (für Arabisch) |
dict |
Wörterbuchartige Sortierung (wie z.B. in Singhalesisch). Auch als dictionary anerkannt. |
emoji |
Empfohlene Sortierreihenfolge für Emoji-Zeichen |
eor |
Europäische Sortierregeln |
phonebk |
Telefonbuchartige Sortierung (wie z.B. in Deutsch). Auch als phonebook anerkannt. |
phonetic |
Phonetische Sortierung (Sortierung basierend auf der Aussprache; für Lingála) |
pinyin |
Pinyin-Sortierung für Latein- und CJK-Zeichen (verwendet in Chinesisch) |
searchjl |
Spezieller Kollisionstyp für die Suche nach koreanischen Anfangskonsonanten. Warnung: Diese Kollision ist nicht für die Sortierung geeignet, obwohl sie nur mit Intl.Collator von usage: "sort" verwendet werden kann. |
stroke |
Pinyin-Sortierung für Latein, Strichreihenfolge für CJK-Zeichen (verwendet in Chinesisch) |
trad |
Traditionelle Sortierreihenfolge (wie z.B. in Spanisch). Auch als traditional anerkannt. |
unihan |
Pinyin-Sortierung für Latein, Unihan-Radikal-Strich-Sortierung für CJK-Zeichen (verwendet in Chinesisch) |
zhuyin |
Pinyin-Sortierung für Latein, Zhuyin-Reihenfolge für Bopomofo und CJK-Zeichen (verwendet in Chinesisch) |
Die unten stehenden Typen sind in den CLDR-Daten angegeben, werden jedoch als veraltet eingestuft, von einer expliziten Nutzung abgeraten und/oder können aus verschiedenen Gründen von Browsern als nicht unterstützt angezeigt werden. Vermeiden Sie deren Nutzung:
Wert | Beschreibung | Anmerkungen |
---|---|---|
big5han
Veraltet
|
Pinyin-Sortierung für Latein, Big5-Zeichensatzsortierung für CJK-Zeichen (verwendet in Chinesisch) | Veraltet. |
direct
Veraltet
|
Binäre Codepunkt-Sortierung (verwendet in Hindi) | Veraltet. |
ducet |
Die Standard-UCS-Kollationselement-Tabelle Sortierung | Der Kollisionstyp ducet ist nicht im Web verfügbar. |
gb2312
Veraltet
|
Pinyin-Sortierung für Latein, GB2312Han-Zeichensatzsortierung für CJK-Zeichen (für Chinesisch). Auch als gb2312han anerkannt. |
Veraltet. |
reformed
Veraltet
|
Reformierte Sortierreihenfolge (wie z.B. auf Schwedisch) | Veraltet. Dies ist der alte Name für die Standard-Sortierung für Schwedisch deren Kollationsnamen sich früher von anderen Sprachen unterschieden. Da dies die Standard-Sortierung war, fordern Sie sv anstatt sv-u-co-reformed an. |
search |
Spezieller Kollationstyp für Zeichenfolgensuche | Verwenden Sie dies nicht als Kollationstyp, da in Intl.Collator diese Kollation über die Option usage: "search" aktiviert wird. Es gibt derzeit keine API für Substringsuche, daher ist dies derzeit nur nützlich, um eine Liste von Zeichenfolgen zu filtern, indem man einen vollständigen Zeichenfolgenabgleich des Schlüssels mit jedem Listenelement versucht. |
standard |
Standard-Sortierung für jede Sprache, außer Chinesisch (und, vorhergehend, Schwedisch) | Nicht explizit verwenden. Im Allgemeinen ist es nicht notwendig, dies explizit anzugeben, und es ist problematisch, dies für Schwedisch anzugeben, da dies in der Vergangenheit eine andere Bedeutung für Schwedisch hatte. |
Referenzen:
Unterstützte Währungs-Identifikatoren
Währungs-Identifikatoren sind dreibuchstabige Großbuchstabencodes, die in ISO 4217 definiert sind. Diese Werte können für die Option currency
verwendet werden, wenn Objekte wie Intl.NumberFormat
erstellt werden, sowie für Intl.DisplayNames.prototype.of()
. Es gibt über 300 Identifikatoren, die häufig verwendet werden, daher werden wir sie nicht auflisten. Für eine umfassende Liste möglicher Identifikatoren siehe den Wikipedia-Artikel.
Referenzen:
Unterstützte Nummerierungssystemtypen
Nachfolgend sind alle Werte aufgeführt, die für den Schlüssel numberingSystem
üblicherweise von Browsern unterstützt werden. Diese Werte können für die numberingSystem
-Option oder den nu
Unicode-Erweiterungsschlüssel verwendet werden, wenn Objekte wie Intl.NumberFormat
erstellt werden. Für die Zeilen mit "Ziffernzeichen" übersetzt die Laufzeit die Ziffern nacheinander ohne zusätzliche Aktionen. Die anderen, als "algorithmisch" markierten, benötigen zusätzliche Algorithmen, um die Ziffern zu übersetzen. Je höher der Unicode-Codepunkt ist, desto neuer ist das Nummerierungssystem und desto wahrscheinlicher ist es, dass es von allen Browsern nicht 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ßbuchstabenzahlen | algorithmisch |
armnlow |
Armenische Kleinbuchstabenzahlen | 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 Zahlen | algorithmisch |
deva |
Devanagari-Ziffern | ०१२३४५६७८९ (U+0966 bis U+096F) |
diak |
Dives-Akuru-Ziffern | 𑥐𑥑𑥒𑥓𑥔𑥕𑥖𑥗𑥘𑥙 (U+11950 bis U+11959) |
ethi |
Äthiopische Zahlen | algorithmisch |
fullwide |
Vollbreite-Ziffern | 0123456789 (U+FF10 bis U+FF19) |
gara |
Garay-Ziffern | (U+10D40 bis U+10D49) |
geor |
Georgische Zahlen | algorithmisch |
gong |
Gunjala-Gondi-Ziffern | 𑶠𑶡𑶢𑶣𑶤𑶥𑶦𑶧𑶨𑶩 (U+11DA0 bis U+11DA9) |
gonm |
Masaram-Gondi-Ziffern | 𑵐𑵑𑵒𑵓𑵔𑵕𑵖𑵗𑵘𑵙 (U+11D50 bis U+11D59) |
grek |
Griechische Großbuchstabenzahlen | algorithmisch |
greklow |
Griechische Kleinbuchstabenzahlen | 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 |
Han-Zeichen für Tag-des-Monats-Nummerierung für Mond-/andere traditionelle Kalender | |
hanidec |
Positionelles Dezimalsystem mit chinesischen Zahlenideographen 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 Zahlen | algorithmisch |
hansfin |
Vereinfachte chinesische Finanzzahlen | algorithmisch |
hant |
Traditionelle chinesische Zahlen | algorithmisch |
hantfin |
Traditionelle chinesische Finanzzahlen | algorithmisch |
hebr |
Hebräische Zahlen | algorithmisch |
hmng |
Pahawh-Hmong-Ziffern | 𖭐𖭑𖭒𖭓𖭔𖭕𖭖𖭗𖭘𖭙 (U+16B50 bis U+16B59) |
hmnp |
Nyiakeng-Puachue-Hmong-Ziffern | 𞅀𞅁𞅂𞅃𞅄𞅅𞅆𞅇𞅈𞅉 (U+1E140 bis U+1E149) |
java |
Javanesische Ziffern | ꧐꧑꧒꧓꧔꧕꧖꧗꧘꧙ (U+A9D0 bis U+A9D9) |
jpan |
Japanische Zahlen | algorithmisch |
jpanfin |
Japanische Finanzzahlen | algorithmisch |
jpanyear |
Japanisches erstes Jahr Gannen Nummerierung für 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 |
Tai-Tham-Hora (weltlich) Ziffern | ᪀᪁᪂᪃᪄᪅᪆᪇᪈᪉ (U+1A80 bis U+1A89) |
lanatham |
Tai-Tham (geistlich) Ziffern | ᪐᪑᪒᪓᪔᪕᪖᪗᪘᪙ (U+1A90 bis U+1A99) |
laoo |
Lao-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 Fettschrift Ziffern | 𝟎𝟏𝟐𝟑𝟒𝟓𝟔𝟕𝟖𝟗 (U+1D7CE bis U+1D7D7) |
mathdbl |
Mathematische Doppelstrich-Ziffern | 𝟘𝟙𝟚𝟛𝟜𝟝𝟞𝟟𝟠𝟡 (U+1D7D8 bis U+1D7E1) |
mathmono |
Mathematische Monospace-Ziffern | 𝟶𝟷𝟸𝟹𝟺𝟻𝟼𝟽𝟾𝟿 (U+1D7F6 bis U+1D7FF) |
mathsanb |
Mathematische Sans-Serif-Fettschrift Ziffern | 𝟬𝟭𝟮𝟯𝟰𝟱𝟲𝟳𝟴𝟵 (U+1D7EC bis U+1D7F5) |
mathsans |
Mathematische Sans-Serif-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 |
Myanmar-Ost-Pwo-Karen-Ziffern | (U+116DA bis U+116E3) |
mymrpao |
Myanmar-Pao-Ziffern | (U+116D0 bis U+116D9) |
mymrshan |
Myanmar-Shan-Ziffern | ႐႑႒႓႔႕႖႗႘႙ (U+1090 bis U+1099) |
mymrtlng |
Myanmar-Tai-Laing-Ziffern | ꧰꧱꧲꧳꧴꧵꧶꧷꧸꧹ (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 |
Legacy-Computing-Umriss Ziffern | (U+1CCF0 bis U+1CCF9) |
rohg |
Hanifi-Rohingya-Ziffern | 𐴰𐴱𐴲𐴳𐴴𐴵𐴶𐴷𐴸𐴹 (U+10D30 bis U+10D39) |
roman |
Römische Großbuchstabenzahlen | algorithmisch |
romanlow |
Römische Kleinbuchstabenzahlen | algorithmisch |
saur |
Saurashtra-Ziffern | ꣐꣑꣒꣓꣔꣕꣖꣗꣘꣙ (U+A8D0 bis U+A8D9) |
segment |
Legacy-Computing segmentsierte Ziffern | 🯰🯱🯲🯳🯴🯵🯶🯷🯸🯹 (U+1FBF0 bis U+1FBF9) |
shrd |
Sharada-Ziffern | 𑇐𑇑𑇒𑇓𑇔𑇕𑇖𑇗𑇘𑇙 (U+111D0 bis U+111D9) |
sind |
Khudawadi-Ziffern | 𑋰𑋱𑋲𑋳𑋴𑋵𑋶𑋷𑋸𑋹 (U+112F0 bis U+112F9) |
sinh |
Singhalesische 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 |
Neue Tai-Lue-Ziffern | ᧐᧑᧒᧓᧔᧕᧖᧗᧘᧙ (U+19D0 bis U+19D9) |
taml |
Tamilische Zahlen | 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) |
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 spezielle Werte: native
, traditio
und finance
, deren Bedeutungen von der Region abhängen und die dem jeweiligen System entsprechend aufgelöst werden. Daher werden die resolvedOptions()
-Methoden diese Werte nie zurückgeben, aber Intl.Locale.prototype.numberingSystem
wird (wenn als Eingabewert bereitgestellt).
Referenzen:
- CLDR-Nummerierungssystem-Typenschlüssel
- CLDR-Nummerierungssystem-Definitionen
- UTS 35, Nummerierungssysteme
Unterstützte Zeitzonen-Identifikatoren
Unterstützte Zeitzonen-Identifikatoren können für die timeZone
-Option verwendet werden, wenn Objekte wie Intl.DateTimeFormat
erstellt werden, sowie für die Erstellung von Temporal
-Datumsobjekten. Es gibt über 400 häufig verwendete Identifikatoren, daher werden wir sie nicht auflisten. Für eine umfassende Liste möglicher Identifikatoren siehe den Wikipedia-Artikel oder die IANA-Zeitzonen-Datenbank.
Beim Durchsuchen der Liste sollte beachtet werden, dass die Standardisierung von Temporal
erfordert, dass Browser immer den primären Identifikator in der IANA-Datenbank zurückgeben, der sich im Laufe der Zeit ändern kann. Siehe Zeitzonen und Verschiebungen für weitere Informationen. Zum Beispiel sollte das zurückgegebene Array "Asia/Kolkata"
enthalten anstelle von "Asia/Calcutta"
, da letzteres ein Alias für ersteres ist und beide Indien entsprechen; es sollte jedoch sowohl "Africa/Abidjan"
als auch "Atlantic/Reykjavik"
enthalten, da sie in verschiedenen Ländern liegen, obwohl letztere auch ein Alias der ersteren ist.
Referenzen:
Unterstützte Einheiten-Identifikatoren
Nachfolgend sind alle Werte aufgeführt, die für den Schlüssel unit
üblicherweise von Browsern unterstützt werden. Diese Werte können für die unit
-Option verwendet werden, wenn Objekte wie Intl.NumberFormat
erstellt werden. Diese Liste ist ein Teil der CLDR, der ausdrücklich von der ECMA-402-Spezifikation genehmigt wurde, damit alle Implementierungen konsistent sind.
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
Beim Angeben von Einheiten können Sie auch zwei Einheiten mit dem "-per-" Separator kombinieren. Zum Beispiel meter-per-second
oder liter-per-megabyte
.
Referenzen:
Ausnahmen
RangeError
-
Wird ausgelöst, wenn ein nicht unterstützter Schlüssel als Parameter übergeben wurde.
Beispiele
Funktionsprüfung
Sie können überprüfen, ob die Methode unterstützt wird, indem Sie mit undefined
vergleichen:
if (typeof Intl.supportedValuesOf !== "undefined") {
// method is supported
}
Alle Werte für den Schlüssel abrufen
Um die unterstützten Werte für Kalender zu erhalten, rufen Sie die Methode mit dem Schlüssel "calendar"
auf.
Sie können dann das zurückgegebene Array wie unten gezeigt durchlaufen:
Intl.supportedValuesOf("calendar").forEach((calendar) => {
// "buddhist", "chinese", "coptic", "dangi", etc.
});
Die anderen Werte werden auf die gleiche Weise erhalten:
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
try {
Intl.supportedValuesOf("someInvalidKey");
} catch (err) {
//Error: RangeError: invalid key: "someInvalidKey"
}
Spezifikationen
Specification |
---|
ECMAScript® 2025 Internationalization API Specification # sec-intl.supportedvaluesof |
Browser-Kompatibilität
BCD tables only load in the browser