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ährungskennungen
• "numberingSystem": siehe unterstützte Zahlensystemtypen
• "timeZone": siehe unterstützte Zeitzonenkennungen
• "unit": siehe unterstützte Einheitenkennungen

Ein sortiertes Array einzigartiger Zeichenfolgenwerte, die die von der Implementierung für den gegebenen Schlüssel unterstützten Werte angeben. Die möglichen zurückgegebenen Werte sind unten aufgeführt.

Unterstützte Kalendertypen

Nachfolgend sind alle Werte aufgeführt, die von Browsern für den calendar-Schlüssel allgemein unterstützt werden. Diese Werte können für die calendar-Option oder den ca- Unicode-Erweiterungsschlüssel beim Erstellen von Objekten wie Intl.DateTimeFormat, sowie für die Erstellung von Temporal-Datumsobjekten verwendet werden.

Die untenstehenden Typen sind im CLDR angegeben, haben aber keine Implementierungen, die in Browsern von den oben genannten Kalendern abweichen.

Referenzen:

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

Unterstützte Kollationstypen

Nachfolgend sind alle Werte aufgeführt, die von Browsern für den collation-Schlüssel allgemein unterstützt werden. Diese Werte können für die collation-Option oder den co- Unicode-Erweiterungsschlüssel beim Erstellen von Objekten wie Intl.Collator verwendet werden.

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

Referenzen:

• CLDR-Kollationstyp-Schlü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 beim Erstellen von Objekten wie Intl.NumberFormat, sowie für Intl.DisplayNames.prototype.of() verwendet werden. Es gibt über 300 weit verbreitete Kennungen, daher werden wir sie nicht alle auflisten. Für eine umfassende Liste möglicher 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 von Browsern für den numberingSystem-Schlüssel allgemein unterstützt werden. Diese Werte können für die numberingSystem-Option oder den nu- Unicode-Erweiterungsschlüssel beim Erstellen von Objekten wie Intl.NumberFormat verwendet werden. Für die Zeilen mit "Ziffernzeichen" übersetzt die Laufzeit die Ziffern ohne weitere Aktionen einzeln. 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 von allen Browsern nicht unterstützt.

Es gibt drei spezielle Werte: native, traditio, und finance, deren Bedeutungen sprachabhängig sind und die je nach Sprache auf das richtige System aufgelöst werden. Daher werden die resolvedOptions()-Methoden diese Werte nie zurückgeben, aber Intl.Locale.prototype.numberingSystem wird es (wenn es als Eingabe angegeben wurde).

Referenzen:

• CLDR-Zahlensystemtyp-Schlüssel
• CLDR-Zahlensystemdefinitionen
• UTS 35, Zahlensysteme

Unterstützte Zeitzonenkennungen

Unterstützte Zeitzonenkennungen können für die timeZone-Option beim Erstellen von Objekten wie Intl.DateTimeFormat, sowie für die Erstellung von Temporal-Datumsobjekten verwendet werden. Es gibt über 400 häufig verwendete Kennungen, deshalb werden wir sie nicht alle auflisten. Für eine umfassende Liste möglicher Kennungen siehe den Wikipedia-Artikel oder die IANA-Zeitzonendatenbank.

Während Sie durch die Liste blättern, beachten Sie, dass die Standardisierung von Temporal von Browsern erfordert, immer den primären Identifikator in der IANA-Datenbank zurückzugeben, der sich im Laufe der Zeit ändern kann. Weitere Informationen finden Sie unter Zeitzonen und Offsets. Beispielsweise sollte das zurückgegebene Array "Asia/Kolkata" anstelle von "Asia/Calcutta" enthalten, da letztere ein Alias der ersteren ist und beide Indien entsprechen; jedoch sollte es sowohl "Africa/Abidjan" als auch "Atlantic/Reykjavik" enthalten, da sie in verschiedenen Ländern liegen, obwohl letzterer auch ein Alias des ersteren ist.

Referenzen:

• IANA-Zeitzonendatenbank
• UTS 35, Zeitzonenkennungen

Unterstützte Einheitenkennungen

Nachfolgend sind alle Werte aufgeführt, die von Browsern für den unit-Key allgemein unterstützt werden. Diese Werte können für die unit-Option beim Erstellen von Objekten wie Intl.NumberFormat verwendet werden. Diese Liste ist ein Untermenge des CLDR, die explizit durch die 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. Beispiel: meter-per-second oder liter-per-megabyte.

Referenzen:

• ECMA-402 genehmigte Einzelunheiten
• CLDR-Einheitsgültigkeitsdaten
• UTS 35, Einheitenkennungen

RangeError

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

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

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

• Polyfill von Intl.supportedValuesOf in FormatJS
• Intl