Intl.supportedValuesOf()

試してみましょう

console.log(Intl.supportedValuesOf("calendar"));
console.log(Intl.supportedValuesOf("collation"));
console.log(Intl.supportedValuesOf("currency"));
console.log(Intl.supportedValuesOf("numberingSystem"));
console.log(Intl.supportedValuesOf("timeZone"));
console.log(Intl.supportedValuesOf("unit"));
// 予想される結果: Array ['key'] (for each key)

try {
  Intl.supportedValuesOf("someInvalidKey");
} catch (err) {
  console.log(err.toString());
  // 予想される結果: RangeError: invalid key: "someInvalidKey"
}

構文

Intl.supportedValuesOf(key)

引数

key

返される値のカテゴリーを示すキー文字列。これは、次のいずれかです。

• "calendar": 対応している暦を参照してください。
• "collation": 対応している照合型を参照してください。
• "currency": 対応している通貨識別子を参照してください。
• "numberingSystem": 対応している記数法を参照してください。
• "timeZone": 対応しているタイムゾーン識別子を参照してください。
• "unit": 対応している単位識別子を参照してください。

返値

指定のキーに対応する、実装で対応している値を表す重複のない文字列のソート済み配列です。

対応している暦

次に示すのは、 calendar キーでブラウザーが一般的に対応しているすべての値です。これらの値は、 Intl.DateTimeFormat などのオブジェクトを作成する場合の calendar オプションまたは ca Unicode 拡張キー、および Temporal 日時オブジェクトの作成に使用することができます。

以下の型は CLDR で指定されていますが、ブラウザーでは上記のカレンダーとは別の実装は存在しません。

参考文献:

• CLDR Calendar type keys
• UTS 35, Dates
• Islamic calendar types (CLDR design proposal)

対応している照合型

以下は、 collation キーとしてブラウザーで一般的に対応しているすべての値です。これらの値は、 collation オプションまたは co Unicode 拡張キーとして、 Intl.Collator などのオブジェクトを作成する際に使用することができます。

下記の型は CLDR データで指定されていますが、非推奨であり、明示的な使用は控えるべきであり、また、さまざまな理由により、ブラウザーが対応していることを示さない場合があります。これらの使用は避けてください。

参考文献:

• CLDR Collation type keys
• UTS 35, Collation

対応している通貨識別子

通貨識別子は、ISO 4217 で定義されている 3 文字の大文字のコードです。これらの値は、 Intl.NumberFormat などのオブジェクトを作成する際に currency オプションとして、また Intl.DisplayNames.prototype.of() にも使用できます。一般的に使用されている識別子は 300 以上あるため、ここではすべては掲載しません。実現可能な識別子の完全なリストについては、ウィキペディアの記事を参照してください。

参考文献:

• CLDR Currency type keys
• ISO 4217 Currency codes
• UTS 35, Currencies

対応している記数法

次のものは、 numberingSystem キーに対してブラウザーが一般的に対応しているすべての値です。これらの値は、 numberingSystem オプションまたは nu Unicode 拡張キーとして Intl.NumberFormat などのオブジェクトを作成する際に使用することができます。「数字の文字」の行の場合、ランタイムは追加の操作を行わずに数字を 1 つずつ対応させます。それ以外で「アルゴリズム」とマークされているものは、数字を対応させるために追加のアルゴリズムが必要です。 Unicode コードポイントが高いほど、数値体系は新しく、すべてのブラウザーで対応していない可能性が高くなります。

3 つの特別な値、native、traditio、finance があります。これらは、その意味はロケールに依存し、ロケールに応じて適切なシステムに解決されます。したがって、resolvedOptions() メソッドはこれらの値を返すことはありませんが、Intl.Locale.prototype.numberingSystem は（入力として指定された場合）これらの値を返します。

参考文献:

• CLDR Numbering system type keys
• CLDR Numbering system definitions
• UTS 35, Numbering systems

対応しているタイムゾーン識別子

対応しているタイムゾーン識別子は、 timeZone オプションに使用して、 Intl.DateTimeFormat などのオブジェクトを作成したり、 Temporal 日時オブジェクトを作成したりすることができます。一般的に使用されている識別子は 400 以上あるため、ここではすべてを記載しません。実現可能な識別子の完全なリストについては、Wikipedia の記事（英語）または IANA タイムゾーンデータベースを参照してください。

リストを閲覧する際は、 Temporal の標準化により、ブラウザーは常に IANA データベースのプライマリ識別子を返すよう要求されていることにご注意ください。プライマリ識別子は時間経過に伴う変更の可能性があります。詳細については、タイムゾーンとオフセットを参照してください。例えば、返される配列には "Asia/Calcutta" ではなく "Asia/Kolkata" が含まれます。これは、後者は前者の別名であり、どちらもインドに対応しているためです。ただし、 "Africa/Abidjan" と "Atlantic/Reykjavik" の場合、後者は前者の別名ですが、異なる国にあるため、両方とも含まれます。

参考文献:

• IANA Time Zone Database
• UTS 35, Time Zone Identifiers

対応している単位識別子

以下は、ブラウザーが unit キーに対して一般的に対応しているすべての値です。これらの値は、Intl.NumberFormat などのオブジェクトを作成する際に、unit オプションとして使用することができます。このリストは、ECMA-402 仕様で明示的に認可されている CLDR のサブセットであるため、すべての実装で一貫性があります。

• acre
• bit
• byte
• celsius
• centimeter
• day
• degree
• fahrenheit
• fluid-ounce
• foot
• gallon
• gigabit
• gigabyte
• gram
• hectare
• hour
• inch
• kilobit
• kilobyte
• kilogram
• kilometer
• liter
• megabit
• megabyte
• meter
• microsecond
• mile
• mile-scandinavian
• milliliter
• millimeter
• millisecond
• minute
• month
• nanosecond
• ounce
• percent
• petabyte
• pound
• second
• stone
• terabit
• terabyte
• week
• yard
• year

単位を指定する場合、2 つの単位を "-per-" という区切り文字で組み合わせることもできます。例えば、 meter-per-second や liter-per-megabyte などです。

参考文献:

• ECMA-402 sanctioned single units
• CLDR Unit validity data
• UTS 35, Unit identifiers

例外

RangeError

引数として未対応のキーが渡されたとき投げられます。

例

機能テスト

undefined と比較することで、このメソッドに対応しているかをチェックできます。

if (typeof Intl.supportedValuesOf !== "undefined") {
  // メソッドに対応している
}

キーに対応するすべての値を取得する

暦に関する対応している値を取得するには、キー "calendar" を指定してこのメソッドを呼び出します。 その後、以下のように返された配列を走査できます。

Intl.supportedValuesOf("calendar").forEach((calendar) => {
  // "buddhist", "chinese", "coptic", "dangi", etc.
});

他の値も、同様にして取得できます。

Intl.supportedValuesOf("collation").forEach((collation) => {
  // "compat", "dict", "emoji", etc.
});

Intl.supportedValuesOf("currency").forEach((currency) => {
  // "ADP", "AED", "AFA", "AFN", "ALK", "ALL", "AMD", etc.
});

Intl.supportedValuesOf("numberingSystem").forEach((numberingSystem) => {
  // "adlm", "ahom", "arab", "arabext", "bali", etc.
});

Intl.supportedValuesOf("timeZone").forEach((timeZone) => {
  // "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", etc.
});

Intl.supportedValuesOf("unit").forEach((unit) => {
  // "acre", "bit", "byte", "celsius", "centimeter", etc.
});

無効なキーでは RangeError が投げられる

try {
  Intl.supportedValuesOf("someInvalidKey");
} catch (err) {
  // RangeError: invalid key: "someInvalidKey"
}

仕様書

ブラウザーの互換性

関連情報

• Intl.supportedValuesOf のポリフィル (FormatJS)
• Intl