在此页

• 句法
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

Intl.getCanonicalLocales() method returns an array containing the canonical locale names. Duplicates will be omitted and elements will be validated as structurally valid language tags.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

句法

Intl.getCanonicalLocales(locales)
					

参数

locales

A list of String values for which to get the canonical locale names.

返回值

An array containing the canonical locale names.

范例

Using getCanonicalLocales

Intl.getCanonicalLocales('EN-US'); // ["en-US"]
Intl.getCanonicalLocales(['EN-US', 'Fr']); // ["en-US", "fr"]
Intl.getCanonicalLocales('EN_US');
// RangeError:'EN_US' is not a structurally valid language tag
					

规范

规范
ECMAScript 国际化 API (ECMA-402) The definition of 'Intl.getCanonicalLocales' in that specification.

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	Desktop						Mobile						Server
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet	Node.js
getCanonicalLocales	Chrome 54	Edge 16	Firefox 48	IE No	Opera No	Safari 11	WebView Android No	Chrome Android No	Firefox Android 56	Opera Android No	Safari iOS 11	Samsung Internet Android No	nodejs 7.0.0

图例

完整支持

完整支持

不支持

不支持

另请参阅

• Intl.NumberFormat.supportedLocalesOf()
• Intl.DateTimeFormat.supportedLocalesOf()
• Intl.Collator.supportedLocalesOf()

元数据

• 最后修改： May 8, 2020

相关话题

1. 标准内置对象
2. Intl
3. 方法
   1. Intl.getCanonicalLocales()
4. 相关页面：
5. Collator
6. DateTimeFormat
7. ListFormat
8. NumberFormat
9. PluralRules
10. RelativeTimeFormat
11. 继承：
12. Object
13. 特性
    1. Object.prototype.__proto__
    2. Object.prototype.constructor
14. 方法
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.valueOf()
    12. Object.setPrototypeOf()