Intl.DisplayNames.prototype.of()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2021 browserübergreifend verfügbar.

Die of() Methode von Intl.DisplayNames Instanzen erhält einen Code und gibt einen String basierend auf der beim Erstellen des Intl.DisplayNames Objekts angegebenen Lokalisierung und Optionen zurück.

In diesem Artikel

Probieren Sie es aus

const regionNamesInEnglish = new Intl.DisplayNames(["en"], { type: "region" });
const regionNamesInTraditionalChinese = new Intl.DisplayNames(["zh-Hant"], {
  type: "region",
});

console.log(regionNamesInEnglish.of("US"));
// Expected output: "United States"

console.log(regionNamesInTraditionalChinese.of("US"));
// Expected output: "美國"

Syntax

of(code)

Parameter

code

Der bereitzustellende code hängt vom type ab:

Ist der Typ "region", sollte code entweder ein zwei-buchstabiger ISO 3166 Regionscode oder ein drei-ziffriger UN M49 geografischer Regionen-Code sein. Er muss der Grammatik des unicode_region_subtag folgen. Verwenden Sie Großbuchstabencodes (z.B. "US"), da Kleinbuchstabencodes (z.B. "us") möglicherweise nicht überall zuverlässig funktionieren.
Ist der Typ "script", sollte code ein vier-buchstabiger ISO 15924 Skriptcode sein. Er muss der Grammatik des unicode_script_subtag folgen.
Ist der Typ "language", sollte code mit dem unicode_language_id Nichtterminal übereinstimmen.
Ist der Typ "currency", sollte code ein drei-buchstabiger ISO 4217 Währungscode sein. Er muss genau drei alphabetische Zeichen haben.
Ist der Typ "dateTimeField", sollte code einer der folgenden sein: "era", "year", "quarter", "month", "weekOfYear", "weekday", "day", "dayPeriod", "hour", "minute", "second", "timeZoneName".
Ist der Typ "calendar", sollte code ein Kalenderschlüssel sein. Er muss der type-Grammatik eines Unicode-Lokalisierungsidentifikators folgen.

Rückgabewert

Ein sprachspezifisch formatierter String oder undefined, wenn keine Daten für die Eingabe vorhanden sind und fallback "none" ist.

Hinweis: fallback wird nur verwendet, wenn code strukturell gültig ist. Siehe die Verwendung von Fallback.

Ausnahmen

RangeError

Wird ausgelöst, wenn code strukturell ungültig für den angegebenen type ist.

Beispiele

Verwendung der of Methode

js
const regionNames = new Intl.DisplayNames("en", { type: "region" });
regionNames.of("419"); // "Latin America"

const languageNames = new Intl.DisplayNames("en", { type: "language" });
languageNames.of("fr"); // "French"

const currencyNames = new Intl.DisplayNames("en", { type: "currency" });
currencyNames.of("EUR"); // "Euro"

const languageNamesStandard = new Intl.DisplayNames("fr", {
  type: "language",
  languageDisplay: "standard",
});
languageNamesStandard.of("fr-CA"); // "français (Canada)"

const languageNamesDialect = new Intl.DisplayNames("fr", {
  type: "language",
  languageDisplay: "dialect",
});
languageNamesDialect.of("fr-CA"); // "français canadien"

Verwendung von Fallback

Wenn Intl.DisplayNames mit fallback: "code" erstellt wird, gibt die of() Methode den code zurück, wenn die Eingabe strukturell gültig aussieht, aber keine Daten für die Eingabe vorhanden sind. Ist fallback "none", wird undefined zurückgegeben.

js
console.log(
  new Intl.DisplayNames("en", { type: "region", fallback: "code" }).of("ZL"),
); // "ZL"

console.log(
  new Intl.DisplayNames("en", { type: "region", fallback: "none" }).of("ZL"),
); // undefined

Dies gilt jedoch nur, wenn der code strukturell gültig ist. Wenn z.B. type "region" ist, aber code nicht der Grammatik des unicode_region_subtag (2 alphabetische Zeichen oder 3 numerische Zeichen) folgt, wird ein RangeError direkt geworfen, anstatt den Fallback zu verwenden.

js
console.log(
  new Intl.DisplayNames("en", { type: "region", fallback: "code" }).of("ZLC"),
); // throws RangeError: invalid value "ZLC" for option region

Intl.DisplayNames

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Intl.DisplayNames
Konstruktor
1. Intl.DisplayNames()
Statische Methoden
1. supportedLocalesOf()
Instanzmethoden
1. of()
2. resolvedOptions()
Vererbung
Object/Function
Statische Methoden
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
Statische Eigenschaften
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
Instanzmethoden
1. __defineGetter__()
2. __defineSetter__()
3. __lookupGetter__()
4. __lookupSetter__()
5. hasOwnProperty()
6. isPrototypeOf()
7. propertyIsEnumerable()
8. toLocaleString()
9. toString()
10. valueOf()
Instanzeigenschaften
1. __proto__
2. constructor
Verwandte Seiten
Intl
Intl.Collator
Intl.DateTimeFormat
Intl.DurationFormat
Intl.ListFormat
Intl.Locale
Intl.NumberFormat
Intl.PluralRules
Intl.RelativeTimeFormat
Intl.Segmenter