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. Dies ist eine der folgenden:

• "calendar": siehe unterstützte Kalenderarten
• "collation": siehe unterstützte Kollationsarten
• "currency": siehe unterstützte Währungskennungen
• "numberingSystem": siehe unterstützte Zahlensystemarten
• "timeZone": siehe unterstützte Zeitzonenkennungen
• "unit": siehe unterstützte Einheitskennungen

Rückgabewert

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

Unterstützte Kalenderarten

Unten stehen alle Werte, die allgemein von Browsern für den Schlüssel calendar 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.

Ab Oktober 2025 funktionieren beim japanese Kalender Daten vor dem 23.10.1868 ISO (dem Startdatum des Jahres 1 Meiji) in Browsern in zwei Arten nicht wie erwartet. 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 es tatsächlich tat. Zweitens gibt die kommende Intl-Epoch- und MonthCode-Vorschlag an, dass Daten vor der Meiji-Ära Gregorianische Epochen verwenden sollten, aber Browser traditionell stattdessen Annäherungen an frühere japanische Epochen verwendet haben. Der japanese Kalender wurde am 1. Januar, 6 Meiji / 1873-01-01 ISO eingeführt, sodass diese Probleme nur proleptische Daten betreffen.

Die unten aufgeführten Typen sind in CLDR spezifiziert, haben jedoch in Browsern keine von den oben genannten Kalendern unterschiedlichen Implementierungen.

Referenzen:

• CLDR Kalender-Typenschlüssel
• UTS 35, Daten
• Islamic calendar types (CLDR Designvorschlag)

Unterstützte Kollationsarten

Unten stehen alle Werte, die allgemein von Browsern für den Schlüssel collation 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 unten aufgeführten Typen sind in CLDR-Daten spezifiziert, sind jedoch veraltet, werden von der expliziten Nutzung abgeraten und/oder möglicherweise nicht von Browsern als unterstützt angezeigt, aus verschiedenen Gründen. Vermeiden Sie deren Verwendung:

Referenzen:

• CLDR Kollation-Typenschlüssel
• UTS 35, Kollation

Unterstützte Währungskennungen

Währungskennungen sind dreibuchstabige Großbuchstabencodes, die in 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 Kennungen, die allgemein verwendet werden, daher werden wir sie nicht alle auflisten. Für eine umfassende Liste möglicher Kennungen sehen Sie sich den Wikipedia-Artikel an.

Referenzen:

• CLDR Währungs-Typenschlüssel
• ISO 4217 Währungscodes
• UTS 35, Währungen

Unterstützte Zahlensystem-Arten

Unten stehen alle Werte, die allgemein von Browsern für den Schlüssel numberingSystem 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 einzeln ohne zusätzliche Aktionen. Für die anderen, die als "algorithmisch" gekennzeichnet sind, sind zusätzliche Algorithmen erforderlich, um die Ziffern zu übersetzen. Je höher der Unicode-Codepunkt ist, desto neuer ist das Zahlensystem und desto wahrscheinlicher wird es von allen Browsern nicht unterstützt.

Es gibt drei spezielle Werte: native, traditio und finance, deren Bedeutungen vom Lokal abhängen und die auf das richtige System entsprechend dem Lokal aufgelöst werden. Daher werden die resolvedOptions()-Methoden niemals diese Werte zurückgeben, aber Intl.Locale.prototype.numberingSystem wird es (wenn als Eingabe angegeben).

Referenzen:

• CLDR Zahlensystem-Typenschlüssel
• CLDR Zahlensystemdefinitionen
• UTS 35, Zahlensysteme

Unterstützte Zeitzonenkennungen

Unterstützte Zeitzonenkennungen 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 Kennungen, die allgemein verwendet werden, daher werden wir sie nicht alle auflisten. Für eine umfassende Liste möglicher Kennungen sehen Sie sich den Wikipedia-Artikel oder die IANA-Zeitzonendatenbank an.

Beachten Sie während des Durchsehens der Liste, dass die Standardisierung von Temporal erfordert, dass Browser immer die primäre Kennung in der IANA-Datenbank zurückgeben, die sich im Laufe der Zeit ändern kann. Weitere Informationen finden Sie unter Zeitzonen und Offsets. Zum Beispiel sollte das zurückgegebene Array "Asia/Kolkata" statt "Asia/Calcutta" enthalten, da Letzteres ein Alias von Ersterem ist und beide Indien entsprechen; es sollte jedoch sowohl "Africa/Abidjan" als auch "Atlantic/Reykjavik" enthalten, da sich diese in verschiedenen Ländern befinden, obwohl Letzteres auch ein Alias von Ersterem ist.

Referenzen:

• IANA-Zeitzonendatenbank
• UTS 35, Zeitzonenkennungen

Unterstützte Einheitskennungen

Unten stehen alle Werte, die allgemein von Browsern für den Schlüssel unit 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 von der CLDR, die ausdrücklich von der ECMA-402-Spezifikation zugelassen ist, 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 Spezifizieren von Einheiten können Sie auch zwei Einheiten mit dem "-pro-" Separator kombinieren. Zum Beispiel, meter-per-second oder liter-per-megabyte.

Referenzen:

• ECMA-402 sanktionierte einzelne Einheiten
• CLDR Einheitengültigkeitsdaten
• UTS 35, Einheitskennungen

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 erhalten

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 durch das zurückgegebene Array wie unten gezeigt iterieren:

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