Intl.DisplayNames

Baseline Weitgehend verfgbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Gerten und in vielen Browserversionen. Sie ist seit April 2021 browserbergreifend verfgbar.

Mehr erfahren
Vollstndige Kompatibilitt anzeigen

Das Intl.DisplayNames Objekt ermglicht die konsistente bersetzung von Sprache, Region und Skript-Anzeigenamen.

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: ""

Konstruktor

Intl.DisplayNames(): Erstellt ein neues Intl.DisplayNames Objekt.

Statische Methoden

Intl.DisplayNames.supportedLocalesOf(): Gibt ein Array zurck, das die von den bereitgestellten Locales enthlt, die untersttzt werden, ohne dass auf die Standardeinstellung des Laufzeitsystems zurckgegriffen werden muss.

Instanz-Eigenschaften

Diese Eigenschaften sind auf Intl.DisplayNames.prototype definiert und werden von allen Intl.DisplayNames Instanzen geteilt.

Intl.DisplayNames.prototype.constructor: Die Konstrukturfunktion, die das Instanzobjekt erstellt hat. Fr Intl.DisplayNames Instanzen ist der Anfangswert der Intl.DisplayNames Konstruktor.
Intl.DisplayNames.prototype[Symbol.toStringTag]: Der Anfangswert der [Symbol.toStringTag] Eigenschaft ist der String "Intl.DisplayNames". Diese Eigenschaft wird in Object.prototype.toString() verwendet.

Instanz-Methoden

Intl.DisplayNames.prototype.of(): Diese Methode erhlt einen code und gibt einen String basierend auf der Locale und den Optionen zurck, die bei der Instanziierung von Intl.DisplayNames bereitgestellt wurden.
Intl.DisplayNames.prototype.resolvedOptions(): Gibt ein neues Objekt mit Eigenschaften zurck, die die Locale und Formatierungsoptionen widerspiegeln, die whrend der Initialisierung des Objekts berechnet wurden.

Beispiele

Region-Code-Anzeigenamen

Um ein Intl.DisplayNames fr eine Locale zu erstellen und den Anzeigenamen fr einen Region-Code zu erhalten.

// Get display names of region in English
let regionNames = new Intl.DisplayNames(["en"], { type: "region" });
regionNames.of("419"); // "Latin America"
regionNames.of("BZ"); // "Belize"
regionNames.of("US"); // "United States"
regionNames.of("BA"); // "Bosnia & Herzegovina"
regionNames.of("MM"); // "Myanmar (Burma)"

// Get display names of region in Traditional Chinese
regionNames = new Intl.DisplayNames(["zh-Hant"], { type: "region" });
regionNames.of("419"); // ""
regionNames.of("BZ"); // ""
regionNames.of("US"); // ""
regionNames.of("BA"); // ""
regionNames.of("MM"); // ""

Sprach-Anzeigenamen

Um ein Intl.DisplayNames fr eine Locale zu erstellen und den Anzeigenamen fr eine Sprach-Skript-Region-Sequenz zu erhalten.

// Get display names of language in English
let languageNames = new Intl.DisplayNames(["en"], { type: "language" });
languageNames.of("fr"); // "French"
languageNames.of("de"); // "German"
languageNames.of("fr-CA"); // "Canadian French"
languageNames.of("zh-Hant"); // "Traditional Chinese"
languageNames.of("en-US"); // "American English"
languageNames.of("zh-TW"); // "Chinese (Taiwan)"]

// Get display names of language in Traditional Chinese
languageNames = new Intl.DisplayNames(["zh-Hant"], { type: "language" });
languageNames.of("fr"); // ""
languageNames.of("zh"); // ""
languageNames.of("de"); // ""

Skript-Code-Anzeigenamen

Um ein Intl.DisplayNames fr eine Locale zu erstellen und den Anzeigenamen fr einen Skript-Code zu erhalten.

// Get display names of script in English
let scriptNames = new Intl.DisplayNames(["en"], { type: "script" });
// Get script names
scriptNames.of("Latn"); // "Latin"
scriptNames.of("Arab"); // "Arabic"
scriptNames.of("Kana"); // "Katakana"

// Get display names of script in Traditional Chinese
scriptNames = new Intl.DisplayNames(["zh-Hant"], { type: "script" });
scriptNames.of("Latn"); // ""
scriptNames.of("Arab"); // ""
scriptNames.of("Kana"); // ""

Whrungs-Code-Anzeigenamen

Um ein Intl.DisplayNames fr eine Locale zu erstellen und den Anzeigenamen fr einen Whrungs-Code zu erhalten.

// Get display names of currency code in English
let currencyNames = new Intl.DisplayNames(["en"], { type: "currency" });
// Get currency names
currencyNames.of("USD"); // "US Dollar"
currencyNames.of("EUR"); // "Euro"
currencyNames.of("TWD"); // "New Taiwan Dollar"
currencyNames.of("CNY"); // "Chinese Yuan"

// Get display names of currency code in Traditional Chinese
currencyNames = new Intl.DisplayNames(["zh-Hant"], { type: "currency" });
currencyNames.of("USD"); // ""
currencyNames.of("EUR"); // ""
currencyNames.of("TWD"); // ""
currencyNames.of("CNY"); // ""

Spezifikationen

Spezifikation
ECMAScript 2027 Internationalization API Specification # intl-displaynames-objects

Browser-Kompatibilitt

Siehe auch

Help improve MDN

War diese bersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen knnen Diese Seite wurde automatisch aus dem Englischen bersetzt.

bersetzung auf GitHub anzeigen Fehler mit dieser bersetzung melden

Standard eingebaute Objekte
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