Intl.supportedValuesOf()

key

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

• "calendar": siehe unterstützte Kalendertypen
• "collation": siehe unterstützte Kollationstypen
• "currency": siehe unterstützte Währungsbezeichner
• "numberingSystem": siehe unterstützte Nummerierungssystemtypen
• "timeZone": siehe unterstützte Zeitzonenbezeichner
• "unit": siehe unterstützte Einheitbezeichner

Ein sortiertes Array mit eindeutigen String-Werten, die die von der Implementierung für den gegebenen Schlüssel unterstützten Werte anzeigen. Die Werte, die zurückgegeben werden könnten, sind unten aufgelistet.

Unterstützte Kalendertypen

Im Folgenden sind alle Werte aufgeführt, die von Browsern häufig für den Schlüssel calendar 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 zur Erstellung von Temporal Datumsobjekten verwendet werden.

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

Referenzen:

• CLDR Kalender-Typenschlüssel
• UTS 35, Daten

Unterstützte Kollationstypen

Im Folgenden sind alle Werte aufgeführt, die von Browsern häufig für den Schlüssel collation 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 angegebenen Typen sind in CLDR-Daten spezifiziert, aber veraltet, werden von der expliziten Verwendung abgeraten und/oder können aus verschiedenen Gründen nicht von Browsern als unterstützte angezeigt werden. Vermeiden Sie deren Verwendung:

Referenzen:

• CLDR Kollationstypenschlüssel
• UTS 35, Kollation

Unterstützte Währungsbezeichner

Währungsbezeichner sind dreistellige 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 im allgemeinen Gebrauch befindliche Bezeichner, daher werden wir sie nicht auflisten. Für eine umfassende Liste möglicher Bezeichner siehe den Wikipedia-Artikel.

Referenzen:

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

Unterstützte Nummerierungssystemtypen

Im Folgenden sind alle Werte aufgeführt, die von Browsern häufig für den Schlüssel numberingSystem 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. Bei den 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 zur Übersetzung der Ziffern. Je höher der Unicode-Codepunkt ist, desto neuer ist das Nummerierungssystem 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 lokalisierungsabhängig sind und je nach Sprachgebiet in das richtige System aufgelöst werden. Daher werden die resolvedOptions()-Methoden diese Werte nie zurückgeben, aber Intl.Locale.prototype.numberingSystem wird es tun (wenn sie als Eingabe bereitgestellt werden).

Referenzen:

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

Unterstützte Zeitzonenbezeichner

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

Beachten Sie beim Durchstöbern der Liste, 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" anstelle von "Asia/Calcutta" enthalten, da 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 von Ersterem ist.

Referenzen:

• IANA Zeitzonendatenbank
• UTS 35, Zeitzonenbezeichner

Unterstützte Einheitbezeichner

Im Folgenden sind alle Werte aufgelistet, die von Browsern häufig für den Schlüssel unit 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 Unterabschnitt des CLDR, der ausdrücklich durch die ECMA-402-Spezifikation sanktioniert ist, damit 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

Wenn Sie Einheiten spezifizieren, können Sie auch zwei Einheiten mit dem Trennzeichen "-per-" kombinieren. Zum Beispiel meter-per-second oder liter-per-megabyte.

Referenzen:

• ECMA-402 sanktionierte Einzel Einheiten
• CLDR Einheitsgültigkeitsdaten
• UTS 35, Einheitsbezeichner

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 mit 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 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 für Intl.supportedValuesOf in FormatJS
• Intl