Intl.NumberFormat.supportedLocalesOf()

概要

ランタイムのデフォルトローケルに戻る必要なしで数値変換でサポートされる提供されたローケルを含んでいる配列を返します。

構文

Intl.NumberFormat.supportedLocalesOf(locales[, options])

引数

locales

BCP47言語タグをもった文字列、そのような文字列の配列。locales引数の一般的な形式に対して、Intl pageを確認して下さい。

options

任意。次のプロパティを持つオブジェクト:

localeMatcher

使用するローケルマッチングアルゴリズム。利用可能な値は"lookup" や "best fit"です。デフォルトは"best fit"です。このオプションについての情報のために、Intl pageを確認して下さい。

説明

localesで提供された言語パックのサブセットをもった配列を返します。返される言語タグでは、ランタイムが使われているローケルマッチングアルゴリズムが考慮して数値変換でローケルをサポートしているので、デフォルトローケルに戻る必要はありません。

例

例: supportedLocalesOfを使う

数値フォーマットで、バリ語ではなく、インドネシア語とドイツ語をサポートしているランタイムを仮定すると、supportedLocalesOf はインドネシア語とドイツ語の言語タグを返します。pinyin は数値フォーマットには適切ではなくインドネシア語では使われていません。インドネシアの特定のドイツ語はサポートされそうにもありません。"lookup"アルゴリズムの指定に注意して下さい。"best fit" はインドネシア語はバリ語に対して、十分にふさわしいと決定するかもしれません。というのも、 ほとんどのバリの人はインドネシア語も理解するからです。それゆえバリ言語タグも同様に返します。

var locales = ['ban', 'id-u-co-pinyin', 'de-ID'];
var options = { localeMatcher: 'lookup' };
console.log(Intl.NumberFormat.supportedLocalesOf(locales, options).join(', '));
// → "id-u-co-pinyin, de-ID"

仕様

ブラウザ実装状況

関連情報

• Intl.NumberFormat