Intl.Locale

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.

* Some parts of this feature may have varying levels of support.

Intl.Locale 对象是 Intl 对象的标准内置属性，用于表示 Unicode 区域标识。

Intl.Locale 对象是为了更便捷地处理 Unicode 区域设置。Unicode 使用字符串作为区域识别标识。区域标识符由语言标识符和扩展标记组成。语言标识符是区域 (locale) 的核心，包含了语言、脚本和地域子标记 (region subtags)。有关区域设置的其他信息体现在可选的扩展标记中。扩展标记保存有关区域设置方面的信息，例如日历类型、时钟类型和编号系统类型。

传统上，Intl 接口像 Unicode 一样使用字符串来表示区域设置，这是一个简单而轻量且效果好的解决方案。但是，添加一个 Locale 类可以更容易地解析和操作语言、脚本、区域以及扩展标记。

构造函数

Intl.Locale(): 实例化一个 Locale 对象。

实例属性

Intl.Locale.prototype.baseName: Returns basic, core information about the Locale in the form of a substring of the complete data string.
Intl.Locale.prototype.calendar: Returns the part of the Locale that indicates the Locale's calendar era.
Intl.Locale.prototype.caseFirst: Returns whether case is taken into account for the locale's collation rules.
Intl.Locale.prototype.collation: Returns the collation type for the Locale, which is used to order strings according to the locale's rules.
Intl.Locale.prototype.hourCycle: Returns the time keeping format convention used by the locale.
Intl.Locale.prototype.language: Returns the language associated with the locale.
Intl.Locale.prototype.numberingSystem: Returns the numeral system used by the locale.
Intl.Locale.prototype.numeric: Returns whether the locale has special collation handling for numeric characters.
Intl.Locale.prototype.region: Returns the region of the world (usually a country) associated with the locale.
Intl.Locale.prototype.script: Returns the script used for writing the particular language used in the locale.

实例方法

Intl.Locale.prototype.maximize(): Gets the most likely values for the language, script, and region of the locale based on existing values.
Intl.Locale.prototype.minimize(): Gets the most likely values for the language, script, and region of the locale based on existing values.
Intl.Locale.prototype.toString(): Returns the Locale's full locale identifier string.

范例

基本使用

很简单，就是需要给Intl.Locale 构造函数传入一个 locale 标识字符串作为参数：

let us = new Intl.Locale("zh-Hans-CN");

使用配置实例化

构造函数支持传入 object 作为配置，object 中可包含多个配置属性。例如，设置 hourCycle 属性，用于设置你所需要的小时周期类型：

let zh12hour = new Intl.Locale("zh-Hans-CN", { hourCycle: "h12" });
console.log(zh12hour.hourCycle); // Prints "h12"

规范

Specification
ECMAScript Internationalization API Specification # locale-objects

浏览器兼容性

BCD tables only load in the browser

参阅

The Intl.Locale Polyfill