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 Kollationstypen
• "currency": siehe unterstützte Währungsidentifikatoren
• "numberingSystem": siehe unterstützte Nummerierungssystemtypen
• "timeZone": siehe unterstützte Zeitzonenidentifikatoren
• "unit": siehe unterstützte Einheitsidentifikatoren

Ein sortiertes Array mit eindeutigen Zeichenfolgenwerten, die die von der Implementierung für den gegebenen Schlüssel unterstützten Werte angeben. Die zurückgegebenen Werte sind unten aufgeführt.

Unterstützte Kalendertypen

Nachfolgend sind alle Werte aufgeführt, die in Browsern üblicherweise 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 zur Erstellung von Temporal-Datum-Objekten.

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

Referenzen:

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

Unterstützte Kollationstypen

Nachfolgend sind alle Werte aufgeführt, die in Browsern üblicherweise 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, aber veraltet, von der expliziten Verwendung abgeraten und/oder dürfen von Browsern aus verschiedenen Gründen nicht als unterstützt angezeigt werden. Vermeiden Sie die Verwendung:

Referenzen:

• CLDR Kollationstyp-Schlüssel
• UTS 35, Kollation

Unterstützte Währungsidentifikatoren

Währungsidentifikatoren sind dreibuchstabige Großcodes, die in ISO 4217 definiert sind. Diese Werte können für die currency-Option verwendet werden, wenn Sie Objekte wie Intl.NumberFormat erstellen, sowie für Intl.DisplayNames.prototype.of(). Es gibt über 300 Identifikatoren in gebräuchlicher Verwendung, daher werden wir sie nicht alle auflisten. Für eine erschöpfende Liste möglicher Identifikatoren siehe den Wikipedia-Artikel.

Referenzen:

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

Unterstützte Nummerierungssystemtypen

Nachfolgend sind alle Werte aufgeführt, die in Browsern üblicherweise 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. Bei den Zeilen mit "Ziffernzeichen" übersetzt die Laufzeit die Ziffern einzeln 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 Nummerierungssystem und desto wahrscheinlicher wird es nicht von allen Browsern unterstützt.

Es gibt drei spezielle Werte: native, traditio und finance, deren Bedeutung ist regionsabhängig und wird entsprechend der Region auf das richtige System aufgelöst. Daher werden die resolvedOptions()-Methoden diese Werte niemals zurückgeben, aber Intl.Locale.prototype.numberingSystem wird dies (falls als Eingabe bereitgestellt) tun.

Referenzen:

• CLDR Nummerierungssystemtypenschlüssel
• CLDR Nummerierungssystemdefinitionen
• UTS 35, Nummerierungssysteme

Unterstützte Zeitzonen-Identifikatoren

Unterstützte Zeitzonen-Identifikatoren können für die timeZone-Option verwendet werden, wenn Sie Objekte wie Intl.DateTimeFormat erstellen, sowie zur Erstellung von Temporal-Datum-Objekten. Es gibt über 400 Identifikatoren in gebräuchlicher Verwendung, so dass wir sie nicht alle auflisten. Für eine erschöpfende Liste möglicher Identifikatoren siehe den Wikipedia-Artikel oder die IANA-Zeitzonen-Datenbank.

Während Sie die Liste durchsuchen, beachten Sie, dass die Standardisierung von Temporal erfordert, dass Browser immer den primären Identifikator in der IANA-Datenbank zurückgeben, der sich im Laufe der Zeit ändern kann. Siehe Zeitzonen und Offsets für mehr Informationen. Zum Beispiel sollte das zurückgegebene Array "Asia/Kolkata" anstelle von "Asia/Calcutta" enthalten, da letzteres ein Alias des ersteren ist und beide zu Indien gehören; es sollte jedoch sowohl "Africa/Abidjan" als auch "Atlantic/Reykjavik" enthalten, da sie in verschiedenen Ländern liegen, obwohl letzteres auch ein Alias des ersteren ist.

Referenzen:

• IANA-Zeitzonen-Datenbank
• UTS 35, Zeitzonenidentifikatoren

Unterstützte Einheitsidentifikatoren

Nachfolgend sind alle Werte aufgelistet, die von Browsern üblicherweise für den Schlüssel unit unterstützt werden. Diese Werte können für die unit-Option verwendet werden, wenn Sie Objekte wie Intl.NumberFormat erstellen. Diese Liste ist eine Untermenge der CLDR, die von der ECMA-402-Spezifikation ausdrücklich sanktioniert 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 Angeben von Einheiten können Sie auch zwei Einheiten mit dem "-per-" Trennzeichen kombinieren. Zum Beispiel meter-per-second oder liter-per-megabyte.

Referenzen:

• ECMA-402 sanktionierte einzelne Einheiten
• CLDR Einheitsgültigkeitsdaten
• UTS 35, Einheit-Identifikatoren

RangeError

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

Sie können überprüfen, ob die Methode durch Vergleichen mit undefined unterstützt wird:

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

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

• Polyfill von Intl.supportedValuesOf in FormatJS
• Intl