Intl.supportedValuesOf()

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 Zeichenfolgen-Schlüssel, der die Kategorie der zurückzugebenden Werte angibt. Dies ist einer von:

• "calendar": siehe unterstützte Kalenderarten
• "collation": siehe unterstützte Sortierarten
• "currency": siehe unterstützte Währungsbezeichner
• "numberingSystem": siehe unterstützte Zahlensystemarten
• "timeZone": siehe unterstützte Zeitzonenbezeichner
• "unit": siehe unterstützte Einheitenbezeichner

Rückgabewert

Ein sortiertes Array einzigartiger Zeichenfolgenwerte, die die von der Implementierung für den angegebenen Schlüssel unterstützten Werte anzeigen. Die zurückgegebenen Werte sind unten aufgeführt.

Unterstützte Kalenderarten

Im Folgenden sind alle Werte aufgeführt, die gängigerweise von Browsern für den calendar Schlüssel unterstützt werden. Diese Werte können für die calendar-Option oder das ca Unicode-Erweiterungsschlüssel beim Erstellen von Objekten wie Intl.DateTimeFormat, sowie zur Erstellung von Temporal Datumsobjekten verwendet werden. Diese Liste ist durch die ECMA-402-Spezifikation ausdrücklich sanktioniert, sodass alle Implementierungen konsistent sein sollten.

Stand Oktober 2025 gibt es im japanese Kalender zwei Probleme bei Daten vor dem 23.10.1868 ISO (dem Startdatum des Jahres 1 Meiji) in Browsern: Erstens, CLDR hatte das falsche Startdatum für die Meiji-Ära, was zur Folge hat, dass Kalenderimplementierungen die Meiji-Ära weiter in die Vergangenheit ausdehnen, als sie tatsächlich war. Zweitens wird im kommenden Intl-Ära und monthCode-Vorschlag spezifiziert, dass Daten vor dem 01.01.1873 ISO Gregorianische Ären verwenden sollten, aber Browser verwendeten traditionell Näherungen früherer japanischer Ären. Der japanese Kalender wurde am 01.01.1873 ISO eingeführt, sodass diese Probleme nur proleptische Daten betreffen.

Die Typen unten sind in CLDR spezifiziert, haben jedoch keine in Browsern von den obigen Kalendern unterscheidbare Implementierungen.

Die Dokumentation zu Temporal.PlainDate.prototype.era und Temporal.PlainDate.prototype.monthCode bieten weitere Informationen zu verschiedenen Kalendern.

Referenzen:

• CLDR Kalender Typenschlüssel
• UTS 35, Daten
• Islamische Kalenderarten (CLDR Designvorschlag)

Unterstützte Sortierarten

Unten sind alle Werte aufgeführt, die gängigerweise von Browsern für den collation Schlüssel unterstützt werden. Diese Werte können für die collation Option oder den co Unicode Erweiterungsschlüssel beim Erstellen von Objekten wie Intl.Collator verwendet werden.

Die folgenden Typen sind in CLDR-Daten spezifiziert, werden jedoch als veraltet angesehen, von der expliziten Nutzung abgeraten und/oder möglicherweise durch Browser aus verschiedenen Gründen nicht als unterstützt angezeigt. Vermeiden Sie deren Verwendung:

Referenzen:

• CLDR Sortiertypenschlüssel
• UTS 35, Sortierungen

Unterstützte Währungsbezeichner

Währungsbezeichner sind drei Buchstaben umfassende Großbuchstabencodes, die in ISO 4217 definiert sind. Diese Werte können für die currency-Option beim Erstellen von Objekten wie Intl.NumberFormat, sowie für Intl.DisplayNames.prototype.of() verwendet werden. Es gibt über 300 Bezeichner, die häufig verwendet werden, sodass wir sie hier nicht alle auflisten. Für eine umfassende Liste der möglichen Bezeichner, siehe den Wikipedia-Artikel.

Referenzen:

• CLDR Währungstype Schlüssel
• ISO 4217 Währungs-Codes
• UTS 35, Währungen

Unterstützte Zahlensysteme

Im Folgenden sind alle Werte aufgeführt, die gängig von Browsern für den numberingSystem Schlüssel unterstützt werden. Diese Werte können für die numberingSystem Option oder den nu Unicode Erweiterungsschlüssel beim Erstellen von Objekten wie Intl.NumberFormat verwendet werden. Für die Zeilen mit "Ziffernzeichen" übersetzt die Laufzeit die Ziffern eins zu eins ohne zusätzliche Aktionen. Bei den anderen, als "algorithmisch" markiert, werden zusätzliche Algorithmen benötigt, um die Ziffern zu übersetzen. Je höher der Unicode-Codepunkt ist, desto neuer ist das Zahlensystem und desto wahrscheinlicher wird es nicht von allen Browsern unterstützt.

Es gibt drei spezielle Werte: native, traditio und finance, deren Bedeutungen von der Region abhängig sind und die je nach Region zum richtigen System aufgelöst werden. Daher werden die resolvedOptions()-Methoden diese Werte niemals zurückgeben, aber Intl.Locale.prototype.numberingSystem wird dies (wenn als Eingabe bereitgestellt).

Referenzen:

• CLDR Zahlensystemtypenschlüssel
• CLDR Zahlensystemdefinitionen
• UTS 35, Zahlensysteme

Unterstützte Zeitzonen-Bezeichner

Unterstützte Bezeichner für Zeitzonen können für die timeZone-Option beim Erstellen von Objekten wie Intl.DateTimeFormat, sowie für das Erstellen von Temporal Datumsobjekten verwendet werden. Es gibt über 400 gängige Bezeichner, daher werden wir sie nicht alle auflisten. Für eine vollständige Liste möglicher Bezeichner siehe den Wikipedia-Artikel oder die IANA Zeitzone-Datenbank.

Beim Durchstöbern der Liste beachten Sie, dass die Standardisierung von Temporal von Browsern erfordert, immer den Hauptbezeichner in der IANA-Datenbank zurückzugeben, wobei sich dieser im Laufe der Zeit ändern kann. Siehe Zeitzonen und Verschiebungen für weitere Informationen. Beispielsweise sollte das zurückgegebene Array "Asia/Kolkata" anstelle von "Asia/Calcutta" enthalten, da letztere ein Alias für ersteres ist und beide zu Indien gehören; aber es sollte sowohl "Africa/Abidjan" als auch "Atlantic/Reykjavik" enthalten, da sie in verschiedenen Ländern sind, obwohl letzteres auch ein Alias für ersteres ist.

Referenzen:

• IANA Zeitzonen-Datenbank
• UTS 35, Zeitzonen-Bezeichner

Unterstützte Einheiten-Bezeichner

Im Folgenden sind alle Werte aufgeführt, die gängig von Browsern für das unit-Schlüssel unterstützt werden. Diese Werte können für die unit-Option beim Erstellen von Objekten wie Intl.NumberFormat verwendet werden. Diese Liste ist ein Teil von CLDR, der explizit durch die ECMA-402-Spezifikation sanktioniert wird, sodass alle Implementierungen konsistent sein sollten.

• 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 Separator "-per-" kombinieren. Zum Beispiel, meter-per-second oder liter-per-megabyte.

Referenzen:

• ECMA-402 sanktionierte Einzel Einheiten
• CLDR Einheiten-Gültigkeitsdaten
• UTS 35, Einheiten-Bezeichner

Ausnahmen

RangeError

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

Beispiele

Funktionstest

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 Schlüssel abrufen

Um die unterstützten Werte für den Kalender zu erhalten, rufen Sie die Methode mit dem Schlüssel "calendar" auf. Sie können dann iterieren durch das zurückgegebene Array wie unten gezeigt:

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 wirft RangeError

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill von Intl.supportedValuesOf in FormatJS
• Intl