在线文档教程

Intl.DateTimeFormat.supportedLocalesOf

Intl.DateTimeFormat.supportedLocalesOf

Intl.DateTimeFormat.supportedLocalesOf()方法返回一个包含日期和时间格式支持的所提供语言环境的数组,而不必回退到运行时的默认语言环境。

句法

Intl.DateTimeFormat.supportedLocalesOf(locales[, options])

参数

locales一个带有BCP 47语言标签的字符串或这种字符串的数组。有关locales参数的一般形式,请参阅Intl页面。options

可选的。可能具有以下属性的对象:

localeMatcher要使用的语言环境匹配算法。可能的值是"lookup""best fit"; 默认是"best fit"。有关此选项的信息,请参阅Intl页面。

返回值

一个字符串数组,表示在日期和时间格式中支持的给定语言环境标记的子集,而不必回退到运行时的默认语言环境。

描述

返回一个数组,其中包含所提供的语言标签的一个子集locales。返回的语言标记是运行时支持日期和时间格式的语言环境的语言标记,使用的语言环境匹配算法认为匹配,因此不必回退到缺省语言环境。

例子

运用 supportedLocalesOf

假设运行时支持印度尼西亚语和德语,但日期和时间格式不支持巴厘语,即使拼音排序与日期和时间格式无关,也不适用于印尼语,而supportedLocalesOf返回印度尼西亚语和德语语言标记不变不太可能得到支持。注意"lookup"这里的算法规范- 一个"best fit"匹配器可能会决定印度尼西亚是巴厘岛足够的匹配,因为大多数巴厘岛的发言者也了解印度尼西亚语,因此也返回巴厘语标签。

var locales = ['ban', 'id-u-co-pinyin', 'de-ID']; var options = { localeMatcher: 'lookup' }; console.log(Intl.DateTimeFormat.supportedLocalesOf(locales, options).join(', ') // → "id-u-co-pinyin, de-ID"

产品规格

SpecificationStatusComment
ECMAScript Internationalization API 1.0 (ECMA-402)The definition of 'Intl.DateTimeFormat.supportedLocalesOf' in that specification.StandardInitial definition.
ECMAScript Internationalization API 2.0 (ECMA-402)The definition of 'Intl.DateTimeFormat.supportedLocalesOf' in that specification.Standard
ECMAScript Internationalization API 4.0 (ECMA-402)The definition of 'Intl.DateTimeFormat.supportedLocalesOf' in that specification.Draft

浏览器兼容性

FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Basic support2429 (29)1115No support

FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
Basic supportNo support2656.0 (56)No supportNo supportNo support