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 Schlüssel-String, der die Kategorie der zurückzugebenden Werte angibt. Mögliche Werte sind:

• "calendar": siehe Unterstützte Kalendertypen
• "collation": siehe Unterstützte Sortierungstypen
• "currency": siehe Unterstützte Währungsbezeichner
• "numberingSystem": siehe Unterstützte Zahlensystemtypen
• "timeZone": siehe Unterstützte Zeitzonenbezeichner
• "unit": siehe Unterstützte Einheitenbezeichner

Rückgabewert

Ein sortiertes Array eindeutiger String-Werte, das angibt, welche Werte die Implementierung für den angegebenen Schlüssel unterstützt. Die möglichen Rückgabewerte sind unten aufgeführt.

Unterstützte Kalendertypen

Im Folgenden sind alle Werte aufgeführt, die Browser für den Schlüssel calendar üblicherweise 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 in der ECMA-402-Spezifikation ausdrücklich zugelassen, sodass alle Implementierungen übereinstimmen sollten.

Stand Oktober 2025 funktionieren Daten vor dem 1868-10-23 ISO (dem Beginn des Jahres 1 Meiji) im Kalender japanese in Browsern in zweierlei Hinsicht 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ückreichte. Zweitens legt der bevorstehende Vorschlag zu Intl-Ären und monthCode fest, dass Daten vor dem 1873-01-01 ISO gregorianische Ären verwenden sollen; Browser haben bisher stattdessen Näherungen früherer japanischer Ären verwendet. Der Kalender japanese wurde am 1. Januar des Jahres 6 Meiji / 1873-01-01 ISO eingeführt. Diese Probleme betreffen daher nur proleptische Daten.

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

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

Referenzen:

• CLDR-Schlüssel für Kalendertypen
• UTS 35, Datumsangaben
• Islamische Kalendertypen (CLDR-Entwurfsvorschlag)

Unterstützte Sortierungstypen

Im Folgenden sind alle Werte aufgeführt, die Browser für den Schlüssel collation üblicherweise 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.

Die folgenden Typen sind in CLDR-Daten festgelegt, aber veraltet, ihre ausdrückliche Verwendung wird nicht empfohlen und/oder Browser weisen sie aus verschiedenen Gründen möglicherweise nicht als unterstützt aus. Vermeiden Sie ihre Verwendung:

Referenzen:

• CLDR-Schlüssel für Sortierungstypen
• UTS 35, Sortierung

Unterstützte Währungsbezeichner

Währungsbezeichner sind dreibuchstabige Codes aus Großbuchstaben, 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. Mehr als 300 Bezeichner sind gebräuchlich, weshalb sie hier nicht aufgeführt werden. Eine vollständige Liste möglicher Bezeichner finden Sie im Wikipedia-Artikel.

Referenzen:

• CLDR-Schlüssel für Währungstypen
• ISO 4217, Währungscodes
• UTS 35, Währungen

Unterstützte Zahlensystemtypen

Im Folgenden sind alle Werte aufgeführt, die Browser für den Schlüssel numberingSystem üblicherweise 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“ übersetzt die Laufzeitumgebung die Ziffern einzeln und ohne zusätzliche Schritte. Für die übrigen, als „algorithmisch“ gekennzeichneten Systeme sind zusätzliche Algorithmen zur Darstellung der Zahlen erforderlich. Je höher der Unicode-Codepunkt ist, desto neuer ist das Zahlensystem und desto wahrscheinlicher ist es, dass kein Browser es unterstützt.

Es gibt drei besondere Werte: native, traditio und finance. Ihre Bedeutung hängt von der Locale ab; sie werden entsprechend der Locale dem passenden Zahlensystem zugeordnet. Die Methoden resolvedOptions() geben diese Werte daher nie zurück, Intl.Locale.prototype.numberingSystem hingegen schon (wenn sie als Eingabe angegeben wurden).

Referenzen:

• CLDR-Schlüssel für Zahlensystemtypen
• CLDR-Definitionen von Zahlensystemen
• UTS 35, Zahlensysteme

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. Mehr als 400 Bezeichner sind gebräuchlich, weshalb sie hier nicht aufgeführt werden. Eine vollständige Liste möglicher Bezeichner finden Sie im Wikipedia-Artikel oder in der IANA-Zeitzonendatenbank.

Beachten Sie beim Durchsehen der Liste, dass Browser aufgrund der Standardisierung von Temporal stets den primären Bezeichner aus der IANA-Datenbank zurückgeben müssen. 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. Es sollte jedoch sowohl "Africa/Abidjan" als auch "Atlantic/Reykjavik" enthalten, da sie zu unterschiedlichen Ländern gehören, obwohl Letzteres ebenfalls ein Alias für Ersteres ist.

Referenzen:

• IANA-Zeitzonendatenbank
• UTS 35, Zeitzonenbezeichner

Unterstützte Einheitenbezeichner

Im Folgenden sind alle Werte aufgeführt, die Browser für den Schlüssel unit üblicherweise 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-Werte, die in der ECMA-402-Spezifikation ausdrücklich zugelassen ist, sodass alle Implementierungen übereinstimmen 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

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:

• In ECMA-402 zugelassene einzelne Einheiten
• CLDR-Daten zur Gültigkeit von Einheiten
• UTS 35, Einheitenbezeichner

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:

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:

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

Die übrigen Werte werden auf dieselbe Weise abgerufen:

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.
});

Ein ungültiger Schlüssel löst RangeError aus

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill für Intl.supportedValuesOf in FormatJS
• Intl