Intl.DisplayNames
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.
Das Intl.DisplayNames
Objekt ermöglicht 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 zurück, das die von den bereitgestellten Locales enthält, die unterstützt werden, ohne dass auf die Standardeinstellung des Laufzeitsystems zurückgegriffen 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. Für
Intl.DisplayNames
Instanzen ist der Anfangswert derIntl.DisplayNames
Konstruktor. Intl.DisplayNames.prototype[Symbol.toStringTag]
-
Der Anfangswert der
[Symbol.toStringTag]
Eigenschaft ist der String"Intl.DisplayNames"
. Diese Eigenschaft wird inObject.prototype.toString()
verwendet.
Instanz-Methoden
Intl.DisplayNames.prototype.of()
-
Diese Methode erhält einen
code
und gibt einen String basierend auf der Locale und den Optionen zurück, die bei der Instanziierung vonIntl.DisplayNames
bereitgestellt wurden. Intl.DisplayNames.prototype.resolvedOptions()
-
Gibt ein neues Objekt mit Eigenschaften zurück, die die Locale und Formatierungsoptionen widerspiegeln, die während der Initialisierung des Objekts berechnet wurden.
Beispiele
Region-Code-Anzeigenamen
Um ein Intl.DisplayNames
für eine Locale zu erstellen und den Anzeigenamen für 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
für eine Locale zu erstellen und den Anzeigenamen für 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
für eine Locale zu erstellen und den Anzeigenamen für 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"); // "片假名"
Währungs-Code-Anzeigenamen
Um ein Intl.DisplayNames
für eine Locale zu erstellen und den Anzeigenamen für einen Währungs-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
Specification |
---|
ECMAScript® 2026 Internationalization API Specification # intl-displaynames-objects |