Intl.DurationFormat.supportedLocalesOf()
Baseline 2025Newly available
Since March 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Intl.DurationFormat.supportedLocalesOf()
静的メソッドは、実行時の既定のロケールに代替されることなく、経過時間の書式に対応する、指定されたロケールの配列を返します。
構文
Intl.DurationFormat.supportedLocalesOf(locales)
Intl.DurationFormat.supportedLocalesOf(locales, options)
引数
locales
-
BCP 47 言語タグを持つ文字列、またはそのような文字列の配列です。
locales
引数の一般的な形式と解釈については、Intl
メインページの引数の説明を参照してください。 options
省略可-
以下のプロパティを持つことがあるオブジェクトです。
localeMatcher
-
使用するロケールの照合アルゴリズムです。指定可能な値は
"lookup"
および"best fit"
で、既定値は"best fit"
です。このオプションの詳細は、 Intl のページを参照してください。
返値
経過時間の書式で、ランタイムの既定のロケールに代替されることなく、指定されたロケールタグのサブセットに対応する文字列の配列です。
例
supportedLocalesOf() の使用
経過時間の書式化で、インドネシア語とドイツ語には対応しているが、バリ語に対応していないランタイムを想定すると、pinyin
照合は経過時間の書式化とは関係がなく、インドネシア語では使用されないにもかかわらず、 supportedLocalesOf
はインドネシア語とドイツ語の言語タグを、変更せずに返します。また、インドネシア語専用のドイツ語が対応している可能性は低いです。
ここで "lookup"
アルゴリズムの仕様に注意してください。 "best fit"
マッチャーは、ほとんどのバリ語話者はインドネシア語も理解するため、インドネシア語がバリ語に適切に一致すると判断し、バリ語の言語タグも返します。
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"]
仕様書
Specification |
---|
Intl.DurationFormat # sec-Intl.DurationFormat.supportedLocalesOf |