Intl.Locale.prototype.language

基线 广泛可用

此功能非常成熟,可在许多设备和浏览器版本中使用。它自 2020 年 9 月.

报告反馈

描述

language 访问器属性 Intl.Locale 实例返回与此区域设置关联的语言。

语言是区域设置的核心属性之一。Unicode 规范将区域设置的语言标识符视为语言和区域的组合(以区分方言和变体,例如英国英语与美国英语)。Intl.Localelanguage 属性严格返回区域设置的语言子标签。language 属性的值在构造时设置,可以通过区域设置标识符的 language 子标签(第一部分)或 Intl.Locale() 构造函数的 language 选项设置。如果两者都存在,后者优先。

示例

language 的设置器为 undefined。您不能直接更改此属性。

与其他区域设置子标签一样,可以通过区域设置字符串或构造函数的配置对象参数将语言添加到 Intl.Locale 对象中。

通过区域设置字符串设置语言

为了成为有效的 Unicode 区域设置标识符,字符串必须以语言子标签开头。 Intl.Locale() 构造函数的主要参数必须是有效的 Unicode 区域设置标识符,因此,无论何时使用构造函数,都必须向其传递包含语言子标签的标识符。
const locale = new Intl.Locale("en-Latn-US");
console.log(locale.language); // Prints "en"

js

通过配置对象参数覆盖语言

为了成为有效的 Unicode 区域设置标识符,字符串必须以语言子标签开头。 Intl.Locale() 构造函数的主要参数必须是有效的 Unicode 区域设置标识符,因此,无论何时使用构造函数,都必须向其传递包含语言子标签的标识符。
const locale = new Intl.Locale("en-Latn-US", { language: "es" });
console.log(locale.language); // Prints "es"

规范

虽然必须指定语言子标签,但 Intl.Locale() 构造函数具有可选的配置对象参数,可以覆盖语言子标签。
规范
# ECMAScript 国际化 API 规范

浏览器兼容性

sec-Intl.Locale.prototype.language

另请参阅