Intl.supportedValuesOf()

key

Ein Schlüsselstring, der die Kategorie der zurückzugebenden Werte angibt. Dies ist einer von:

• "calendar": siehe unterstützte Kalendertypen
• "collation": siehe unterstützte Sortiertypen
• "currency": siehe unterstützte Währungskennungen
• "numberingSystem": siehe unterstützte Zahlensystemtypen
• "timeZone": siehe unterstützte Zeitzonenkennungen
• "unit": siehe unterstützte Einheitenkennungen

Ein sortiertes Array von eindeutigen Stringwerten, die die Werte anzeigen, die von der Implementierung für den gegebenen Schlüssel unterstützt werden. Die möglicherweise zurückgegebenen Werte sind unten aufgelistet.

Unterstützte Kalendertypen

Nachfolgend sind alle Werte aufgeführt, die in Browsern allgemein 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 zum Erstellen von Temporal-Datumsobjekten.

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

Referenzen:

• CLDR Kalendertyp-Schlüssel
• UTS 35, Datumsangaben
• Islamische Kalendertypen (CLDR Designvorschlag)

Unterstützte Sortiertypen

Nachfolgend sind alle Werte aufgeführt, die in Browsern allgemein 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 angegebenen Typen sind in CLDR-Daten spezifiziert, sind jedoch veraltet, sind von der expliziten Verwendung abgeraten und/oder werden möglicherweise nicht von Browsern als unterstützt angezeigt. Vermeiden Sie die Verwendung dieser:

Referenzen:

• CLDR Sortiertyp-Schlüssel
• UTS 35, Sortierung

Unterstützte Währungskennungen

Währungskennungen sind drei Buchstaben lange 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 häufig verwendet werden, weshalb wir sie nicht alle auflisten. Für eine vollständige Liste der möglichen Kennungen siehe den Wikipedia-Artikel.

Referenzen:

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

Unterstützte Zahlensystemtypen

Nachfolgend sind alle Werte aufgeführt, die üblicherweise 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. Die anderen, die als "algorithmisch" gekennzeichnet 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 wird es nicht von allen Browsern unterstützt.

Es gibt drei spezielle Werte: native, tradition, und finance, deren Bedeutungen ortsabhängig sind und je nach Gebietsschema auf das richtige System aufgelöst werden. Daher werden diese Werte nie von den Methoden resolvedOptions() zurückgegeben, aber Intl.Locale.prototype.numberingSystem wird (wenn als Eingabe bereitgestellt).

Referenzen:

• CLDR Zahlensystemtyp-Schlü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, sowie beim Erstellen von Temporal-Datumsobjekten. Es gibt über 400 Kennungen, die häufig verwendet werden, deshalb werden wir sie nicht alle auflisten. Für eine vollständige Liste der möglichen Kennungen siehe den Wikipedia-Artikel oder die IANA-Zeitzonendatenbank.

Während Sie die Liste durchsehen, beachten Sie, dass die Standardisierung von Temporal die Browser dazu verpflichtet, immer den primären Bezeichner in der IANA-Datenbank zurückzugeben, der sich im Laufe der Zeit ändern kann. Für weitere Informationen siehe Zeitzonen und Offsets. Zum Beispiel sollte das zurückgegebene Array "Asia/Kolkata" anstelle von "Asia/Calcutta" enthalten, da letzteres ein Alias des ersteren ist und beide Indien entsprechen; jedoch sollte es sowohl "Africa/Abidjan" als auch "Atlantic/Reykjavik" enthalten, da sie sich in verschiedenen Ländern befinden, obwohl letzteres auch ein Alias des ersteren ist.

Referenzen:

• IANA-Zeitzonendatenbank
• UTS 35, Zeitzonenkennungen

Unterstützte Einheitenkennungen

Nachfolgend sind alle Werte aufgeführt, die in Browsern allgemein 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 des CLDR, das explizit von der ECMA-402 Spezifikation genehmigt wurde, 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 "-per-" Separator kombinieren. Zum Beispiel meter-per-second oder liter-per-megabyte.

Referenzen:

• ECMA-402 genehmigte Einzelgeräte
• CLDR Einheitlichkeitsdaten
• UTS 35, Einheitenkennungen

RangeError

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

Sie können überprüfen, ob die Methode unterstützt wird, indem Sie auf undefined vergleichen:

if (typeof Intl.supportedValuesOf !== "undefined") {
  // method is supported
}

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

• Polyfill von Intl.supportedValuesOf in FormatJS
• Intl