Intl.RelativeTimeFormat.supportedLocalesOf()

基线 广泛可用

此功能已经完善,可以在许多设备和浏览器版本中使用。它已在所有浏览器中可用,从 2020 年 9 月.

Intl.RelativeTimeFormat.supportedLocalesOf() 静态方法返回一个数组,其中包含在相对时间格式化中支持的提供的区域设置,而无需回退到运行时的默认区域设置。

尝试一下

语法

js
Intl.RelativeTimeFormat.supportedLocalesOf(locales)
Intl.RelativeTimeFormat.supportedLocalesOf(locales, options)

参数

locales

具有 BCP 47 语言标签的字符串,或此类字符串的数组。有关 locales 参数的一般形式和解释,请参阅 Intl 主页上的参数描述.

options 可选

一个对象,可以包含以下属性

localeMatcher

要使用的区域设置匹配算法。可能的值是 "lookup""best fit";默认值为 "best fit"。有关此选项的信息,请参阅 Intl 页面。

返回值

一个字符串数组,表示在相对时间格式化中支持的给定区域设置标签的子集,而无需回退到运行时的默认区域设置。

示例

使用 supportedLocalesOf()

假设运行时支持印尼语和德语,但不支持巴厘语,supportedLocalesOf 返回印尼语和德语语言标签,保持不变,即使 pinyin 排序与相对时间格式化无关,也不与印尼语一起使用,并且不太可能支持专门针对印尼的德语。请注意这里对 "lookup" 算法的说明——"best fit" 匹配器可能会决定印尼语是巴厘语的适当匹配,因为大多数巴厘语使用者也理解印尼语,因此也会返回巴厘语语言标签。

js
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.RelativeTimeFormat.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]

规范

规范
ECMAScript 国际化 API 规范
# sec-Intl.RelativeTimeFormat.supportedLocalesOf

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅