Intl.DisplayNames

Intl.DisplayNames 对象可以实现语言、区域和脚本显示名称的一致翻译。

¥The Intl.DisplayNames object enables the consistent translation of language, region and script display names.

Try it

构造函数

¥Constructor

Intl.DisplayNames()

创建一个新的 Intl.DisplayNames 对象。

静态方法

¥Static methods

Intl.DisplayNames.supportedLocalesOf()

返回一个数组,其中包含所提供的受支持的语言环境,而无需回退到运行时的默认语言环境。

实例属性

¥Instance properties

这些属性在 Intl.DisplayNames.prototype 上定义并由所有 Intl.DisplayNames 实例共享。

¥These properties are defined on Intl.DisplayNames.prototype and shared by all Intl.DisplayNames instances.

Intl.DisplayNames.prototype.constructor

创建实例对象的构造函数。对于 Intl.DisplayNames 实例,初始值为 Intl.DisplayNames 构造函数。

Intl.DisplayNames.prototype[Symbol.toStringTag]

[Symbol.toStringTag] 属性的初始值为字符串 "Intl.DisplayNames"。该属性在 Object.prototype.toString() 中使用。

实例方法

¥Instance methods

Intl.DisplayNames.prototype.of()

此方法接收 code 并根据实例化 Intl.DisplayNames 时提供的区域设置和选项返回一个字符串。

Intl.DisplayNames.prototype.resolvedOptions()

返回一个新对象,其属性反映了在对象初始化期间计算的区域设置和格式选项。

示例

¥Examples

区域代码显示名称

¥Region Code Display Names

为区域设置创建 Intl.DisplayNames 并获取区域代码的显示名称。

¥To create an Intl.DisplayNames for a locale and get the display name for a region code.

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

语言显示名称

¥Language Display Names

为区域设置创建 Intl.DisplayNames 并获取语言-脚本-区域序列的显示名称。

¥To create an Intl.DisplayNames for a locale and get the display name for a language-script-region sequence.

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

脚本代码显示名称

¥Script Code Display Names

为区域设置创建 Intl.DisplayNames 并获取脚本代码的显示名称。

¥To create an Intl.DisplayNames for a locale and get the display name for a script code.

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

货币代码显示名称

¥Currency Code Display Names

为区域设置创建 Intl.DisplayNames 并获取货币代码的显示名称。

¥To create an Intl.DisplayNames for a locale and get the display name for currency code.

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

规范

Specification
ECMAScript Internationalization API Specification
# intl-displaynames-objects

¥Specifications

浏览器兼容性

BCD tables only load in the browser

¥Browser compatibility

也可以看看

¥See also