Intl.RelativeTimeFormat.supportedLocalesOf()

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年9月以降、すべてのブラウザーで利用可能です。

Intl.RelativeTimeFormat.supportedLocalesOf() は静的メソッドで、ランタイムのデフォルトのロケールに代替されることなく、数値の書式化に対応する、指定されたロケールを含む配列を返します。

試してみましょう

const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };

console.log(Intl.RelativeTimeFormat.supportedLocalesOf(locales, options));
// 予想される結果: Array ["id-u-co-pinyin", "de-ID"]
// （メモ: 正確な出力はブラウザーによって異なる場合があります）

構文

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

引数

locales

BCP 47 言語タグを持つ文字列、またはそのような文字列の配列です。 locales 引数の一般的な形式については、 Intl メインページにある引数の説明を参照してください。

options 省略可

以下のプロパティを持つことがあるオブジェクトです。

localeMatcher: 使用するロケールの一致アルゴリズムです。指定可能な値は "lookup" および "best fit" で、デフォルト値は "best fit" です。このオプションの詳細は、 Intl のページを参照してください。

返値

指定したロケールタグのサブセットを表す文字列の配列で、ランタイムのデフォルトのロケールで代替する必要なく数値の書式で対応されているものを含みます。

数値の書式でインドネシア語とドイツ語に対応しており、バリ語に対応していないランタイムを想定すると、 supportedLocalesOf はインドネシア語とドイツ語の言語タグを変更せずに返しますが、 pinyin の照合は数値の書式には関係なく、インドネシア語でも使用されません。ここでの "lookup" アルゴリズムの仕様に注意してください — バリ語話者のほとんどはインドネシア語も理解しているので、 "best fit" の照合子はインドネシア語がバリ語に適切に一致すると判断し、バリ語の言語タグも返すかもしれません。

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"]