Intl.DateTimeFormat.supportedLocalesOf()
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2017年9月以降、すべてのブラウザーで利用可能です。
Intl.DateTimeFormat.supportedLocalesOf() は静的メソッドで、ランタイムの既定のロケールで代替する必要なく日時の書式で対応されているものを含む配列を返します。
試してみましょう
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.DateTimeFormat.supportedLocalesOf(locales, options));
// 予想される結果: Array ["id-u-co-pinyin", "de-ID"]
// (注: 正確な出力結果はブラウザーに依存することがあります)
構文
js
Intl.DateTimeFormat.supportedLocalesOf(locales)
Intl.DateTimeFormat.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.DateTimeFormat.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Internationalization API Specification # sec-intl.datetimeformat.supportedlocalesof |