Intl.DisplayNames

Объект Intl.DisplayNames обеспечивает согласованный перевод названий языков, регионов и письменности.

Попробуйте

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

Конструктор

Intl.DisplayNames()

Создает новый объект Intl.DisplayNames.

Статические методы

Intl.DisplayNames.supportedLocalesOf()

Возвращает массив из предоставленных локалей, которые поддерживаются без необходимости использовать локаль по умолчанию среды выполнения.

Свойства экземпляра

Эти свойства определены для Intl.DisplayNames.prototype и совместно используются всеми экземплярами Intl.DisplayNames.

Intl.DisplayNames.prototype.constructor

Конструктор, который создал объект экземпляра. Для экземпляров Intl.DisplayNames начальным значением является конструктор Intl.DisplayNames.

Intl.DisplayNames.prototype[Symbol.toStringTag]

Начальным значением свойства [Symbol.toStringTag] является строка "Intl.DisplayNames". Это свойство используется в Object.prototype.toString().

Методы экземпляра

Intl.DisplayNames.prototype.of()

Этот метод принимает code и возвращает строку на основе локали и параметров, предоставленных при создании экземпляра Intl.DisplayNames.

Intl.DisplayNames.prototype.resolvedOptions()

Возвращает новый объект со свойствами, отражающими локаль и параметры форматирования, вычисленные во время инициализации объекта.

Примеры

Названия кодов регионов

Чтобы создать Intl.DisplayNames для локали и получить отображаемое название для кода региона.

// 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"); // "緬甸"

Названия кодов языков

Чтобы создать Intl.DisplayNames для локали и получить отображаемое название для последовательности язык-письменность-регион.

// 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"); // "德文"

Названия кодов письменности

Чтобы создать Intl.DisplayNames для локали и получить отображаемое название для кода письменности.

// 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"); // "片假名"

Названия кодов валют

Чтобы создать Intl.DisplayNames для локали и получить отображаемое название для кода валюты.

// 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"); // "人民幣"

Спецификации

Совместимость с браузерами

См. также

• Полифилл для Intl.DisplayNames в FormatJS
• Intl