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ückgegebenen Werte angibt. Dies ist einer der folgenden:

• "calendar": siehe unterstützte Kalendertypen
• "collation": siehe unterstützte Kollationstypen
• "currency": siehe unterstützte Währungsbezeichner
• "numberingSystem": siehe unterstützte Zahlensystemtypen
• "timeZone": siehe unterstützte Zeitzonenbezeichner
• "unit": siehe unterstützte Einheit-Bezeichner

Rückgabewert

Ein sortiertes Array einzigartiger String-Werte, die die von der Implementierung für den gegebenen Schlüssel unterstützten Werte angeben. Die Werte, die zurückgegeben werden könnten, sind unten aufgeführt.

Unterstützte Kalendertypen

Nachfolgend sind alle Werte aufgeführt, die von Browsern häufig für den calendar Schlüssel 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 Datumobjekten. Diese Liste wird ausdrücklich durch die ECMA-402-Spezifikation sanktioniert, sodass alle Implementierungen konsistent sein sollten.

Stand Oktober 2025 funktionieren im japanese Kalender die Daten vor dem 23.10.1868 ISO (dem Startdatum des Jahres 1 Meiji) in Browsern nicht wie erwartet, und zwar in zwei Weisen. Erstens hatte CLDR das falsche Startdatum für die Meiji-Ära, was dazu führt, dass Kalenderimplementierungen die Meiji-Ära weiter in die Vergangenheit ausdehnen, als sie tatsächlich war. Zweitens gibt die bevorstehende Intl-Ära und Monatscode-Vorschlag an, dass Daten vor dem 01.01.1873 ISO gregorianische Ären verwenden sollten, aber Browser traditionell Annäherungen vorhergehender japanischer Ären verwendet haben. Der japanese Kalender wurde am 1. Januar, 6 Meiji / 01.01.1873 ISO, in Gebrauch genommen, daher betreffen diese Probleme nur proleptische Daten.

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

Die Temporal.PlainDate.prototype.era und Temporal.PlainDate.prototype.monthCode Dokumentationen bieten weitere Informationen über verschiedene Kalender.

Referenzen:

• CLDR Kalendertypen Schlüssel
• UTS 35, Daten
• Islamische Kalendertypen (CLDR Designvorschlag)

Unterstützte Kollationstypen

Nachfolgend sind alle Werte aufgeführt, die von Browsern häufig für den collation Schlüssel 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.

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

Referenzen:

• CLDR Kollationstypen Schlüssel
• UTS 35, Kollation

Unterstützte Währungsbezeichner

Währungsbezeichner sind dreistellige Buchstabencodes in Großbuchstaben, die im ISO 4217 definiert sind. Diese Werte können für die currency-Option verwendet werden, wenn Objekte wie Intl.NumberFormat erstellt werden, sowie für Intl.DisplayNames.prototype.of(). Es gibt über 300 Bezeichner im allgemeinen Gebrauch, daher werden wir sie nicht auflisten. Für eine umfassende Liste möglicher Bezeichner siehe den Wikipedia-Artikel.

Referenzen:

• CLDR Währungsbezeichner Schlüssel
• ISO 4217 Währungscodes
• UTS 35, Währungen

Unterstützte Zahlensystemtypen

Nachfolgend sind alle Werte aufgeführt, die von Browsern häufig für den numberingSystem Schlüssel 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 eins zu eins ohne zusätzliche Aktionen. Die anderen, die als "algorithmisch" markiert sind, benötigen zusätzliche Algorithmen, um die Ziffern zu übersetzen. Je höher der Unicode-Codepunkt ist, desto neuer ist das Zahlensystem und desto wahrscheinlicher ist es, dass es von allen Browsern nicht unterstützt wird.

Es gibt drei spezielle Werte: native, traditio und finance, deren Bedeutungen von den Lokalen abhängen und vom Lokale-Skript in das richtige System aufgelöst werden. Daher werden die resolvedOptions() Methoden niemals diese Werte zurückgeben, aber Intl.Locale.prototype.numberingSystem wird es (wenn es als Eingabe übergeben wurde).

Referenzen:

• CLDR Zahlensystemtypen Schlüssel
• CLDR Zahlensystemdefinitionen
• UTS 35, Zahlensysteme

Unterstützte Zeitzonenbezeichner

Unterstützte Zeitzonenbezeichner können für die timeZone Option verwendet werden, wenn Objekte wie Intl.DateTimeFormat erstellt werden, sowie für die Erstellung von Temporal Datumobjekten. Es gibt über 400 Bezeichner im allgemeinen Gebrauch, daher werden wir sie nicht auflisten. Für eine umfassende Liste möglicher Bezeichner siehe den Wikipedia-Artikel oder die IANA-Zeitzonendatenbank.

Beim Durchsuchen der Liste beachten Sie, dass die Standardisierung von Temporal erfordert, dass Browser immer den primären Bezeichner in der IANA-Datenbank zurückgeben, der sich im Laufe der Zeit ändern kann. Siehe Zeitzonen und Offsets für weitere Informationen. Beispielsweise sollte das zurückgegebene Array "Asia/Kolkata" statt "Asia/Calcutta" enthalten, weil letzteres ein Alias für ersteres ist und beide zu Indien gehören; es sollte jedoch sowohl "Africa/Abidjan" als auch "Atlantic/Reykjavik" enthalten, weil sie sich in verschiedenen Ländern befinden, obwohl letzteres auch ein Alias für ersteres ist.

Referenzen:

• IANA Zeitzonendatenbank
• UTS 35, Zeitzonenbezeichner

Unterstützte Einheit-Bezeichner

Nachfolgend sind alle Werte aufgeführt, die von Browsern häufig für den unit Schlüssel 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 Teilset der CLDR, das ausdrücklich von der ECMA-402-Spezifikation sanktioniert wird, so dass 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

Bei der Angabe von Einheiten können Sie auch zwei Einheiten mit dem "-per-" Separator kombinieren. Zum Beispiel: meter-per-second oder liter-per-megabyte.

Referenzen:

• ECMA-402 sanktionierte Einzeleinheiten
• CLDR Einheit Gültigkeitsdaten
• UTS 35, Einheit-Bezeichner

Ausnahmen

RangeError

Wird geworfen, wenn ein nicht unterstützter Schlüssel als Parameter übergeben wurde.

Beispiele

Funktionstest

Sie können prü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 Kalender abzurufen, rufen Sie die Methode mit dem Schlüssel "calendar" auf. Sie können dann durch das zurückgegebene Array iterieren, wie unten gezeigt:

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

Die anderen Werte werden alle auf die gleiche 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.
});

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