Intl.Locale.prototype.region

Baseline 已广泛支持

此功能已成熟,并可在许多设备和浏览器版本上使用。自 2020 年 9 月起,所有浏览器均已提供此功能。

region 访问器属性是 Intl.Locale 实例的一部分,它返回与此区域设置相关的世界区域(通常是一个国家)。

描述

区域是区域设置的核心属性之一。它允许区分同一语言在不同国家之间的差异。例如,英语在英国和美利坚合众国都有使用,但这两个国家在拼写和其他语言惯例上存在差异。了解区域设置的区域有助于 JavaScript 程序员确保他们的网站和应用程序的内容在世界不同地区查看时能够正确显示。

region 属性的值在构造时设置,可以通过区域标识符中 script 后面的部分,也可以通过 Intl.Locale() 构造函数的 region 选项来设置。如果两者都存在,后者具有优先权;如果两者都不存在,则该属性的值为 undefined

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

示例

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

通过区域字符串添加区域

区域(如果存在)是有效的 Unicode 语言标识符字符串的第三部分(如果存在 script,则为第二部分,否则为第三部分),可以添加到传递给 Intl.Locale() 构造函数的初始区域字符串中。请注意,区域不是区域标识符的必需部分。

js
const locale = new Intl.Locale("en-Latn-US");
console.log(locale.region); // "US"

通过配置对象参数添加区域

Intl.Locale() 构造函数有一个可选的配置对象参数。将配置对象的 region 属性设置为您想要的区域,然后将其传递给构造函数。

js
const locale = new Intl.Locale("fr-Latn", { region: "FR" });
console.log(locale.region); // "FR"

规范

规范
ECMAScript® 2026 国际化 API 规范
# sec-Intl.Locale.prototype.region

浏览器兼容性

另见