Intl.DisplayNames
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.
Das Intl.DisplayNames-Objekt ermöglicht die einheitliche Übersetzung von Anzeigenamen für Sprachen, Regionen und Schriftsysteme.
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 mit den bereitgestellten Locales zurück, die unterstützt werden, ohne auf die Standard-Locale der Laufzeitumgebung zurückgreifen zu müssen.
Instanzeigenschaften
Diese Eigenschaften sind auf Intl.DisplayNames.prototype definiert und werden von allen Intl.DisplayNames-Instanzen gemeinsam genutzt.
Intl.DisplayNames.prototype.constructor-
Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für
Intl.DisplayNames-Instanzen ist der Anfangswert der KonstruktorIntl.DisplayNames. Intl.DisplayNames.prototype[Symbol.toStringTag]-
Der Anfangswert der Eigenschaft
[Symbol.toStringTag]ist die Zeichenfolge"Intl.DisplayNames". Diese Eigenschaft wird inObject.prototype.toString()verwendet.
Instanzmethoden
Intl.DisplayNames.prototype.of()-
Diese Methode nimmt einen
codeentgegen und gibt eine Zeichenfolge zurück, die auf der Locale und den Optionen basiert, die bei der Erstellung derIntl.DisplayNames-Instanz angegeben wurden. Intl.DisplayNames.prototype.resolvedOptions()-
Gibt ein neues Objekt mit Eigenschaften zurück, die die bei der Initialisierung des Objekts ermittelte Locale und die Formatierungsoptionen widerspiegeln.
Beispiele
Anzeigenamen für Regionscodes
So erstellen Sie ein Intl.DisplayNames-Objekt für eine Locale und erhalten den Anzeigenamen für einen Regionscode.
// 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"); // "緬甸"
Anzeigenamen für Sprachen
So erstellen Sie ein Intl.DisplayNames-Objekt für eine Locale und erhalten den Anzeigenamen für eine Sprach-Schrift-Region-Sequenz.
// 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"); // "德文"
Anzeigenamen für Schriftsystemcodes
So erstellen Sie ein Intl.DisplayNames-Objekt für eine Locale und erhalten den Anzeigenamen für einen Schriftsystemcode.
// 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"); // "片假名"
Anzeigenamen für Währungscodes
So erstellen Sie ein Intl.DisplayNames-Objekt für eine Locale und erhalten den Anzeigenamen für einen Währungscode.
// 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 |