Intl.DurationFormat.supportedLocalesOf()

基準線 2025
新推出

自 ⁨2025 年 3 月⁩ 起,此功能可在最新的裝置和瀏覽器版本上使用。此功能可能在舊裝置或瀏覽器上無法正常工作。

Intl.DurationFormat.supportedLocalesOf() 靜態方法返回一個數組,其中包含提供的區域設定中支援時長格式而無需回退到執行時預設區域設定的區域設定。

語法

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

引數

locales

一個帶有 BCP 47 語言標籤的字串,或者此類字串的陣列。關於 locales 引數的一般形式和解釋,請參閱 Intl 主頁上的引數說明

options 可選

一個可能具有以下屬性的物件

localeMatcher

要使用的 locale 匹配演算法。可能的值為 "lookup""best fit";預設值為 "best fit"。有關此選項的資訊,請參閱 Intl 頁面。

返回值

一個字串陣列,代表提供的區域設定標籤的一個子集,這些標籤在時長格式中得到支援,而無需回退到執行時的預設區域設定。

示例

使用 supportedLocalesOf()

假設一個執行時支援印尼語和德語,但不支援巴釐語進行時長格式化,supportedLocalesOf 會原樣返回印尼語和德語的語言標籤,即使拼音排序既與時長格式化無關,也未與印尼語一起使用,而且不太可能支援針對印度尼西亞的專門德語。請注意此處指定的 "lookup" 演算法 — "best fit" 匹配器可能會決定印尼語是巴釐語的足夠匹配項,因為大多數巴釐語使用者也理解印尼語,因此也會返回巴釐語的語言標籤。

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

規範

規範
Intl.DurationFormat
# sec-Intl.DurationFormat.supportedLocalesOf

瀏覽器相容性

另見