Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【JavaScript ECMAScript】Intl::Intl.Locale.prototype.variantsインスタンスアクセサプロパティの使い方

Intl.Locale.prototype.variantsインスタンスアクセサプロパティの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

Intl.Locale.prototype.variantsプロパティは、Intl.Localeオブジェクトが表すロケール識別子に含まれる「バリアント」情報を保持するプロパティです。

Intl.Localeオブジェクトは、ユーザーの言語や地域といった国際化情報をプログラムで扱えるようにするためのJavaScriptの組み込みオブジェクトです。このオブジェクトは、en-US(アメリカ英語)やja-JP(日本での日本語)のようなロケール識別子を解析し、その構成要素にアクセスする機能を提供します。

variantsプロパティは、ロケール識別子のうち、言語や地域といった主要な情報に加えて、より特定の書記体系、文化的な差異、またはその他の技術的なバリアント情報が含まれている場合に、それらのサブタグのリストを文字列の配列として提供します。例えば、特定の古い書記体系を指定するような、言語や地域以外の詳細な識別子が含まれる場合に利用されます。

このプロパティは読み取り専用であり、その値は、ロケール識別子から抽出されたバリアントタグの文字列が格納されたArray(配列)です。もし、基となるロケール識別子にバリアント情報が含まれていない場合は、空の配列が返されます。国際化されたアプリケーションで、言語や地域だけでなく、さらに特定の文化や技術的な側面を考慮した表示や処理を必要とする場合に、このバリアント情報を参照することができます。

公式リファレンス: Intl.Locale.prototype.variants

構文(syntax)

1new Intl.Locale('en-US-u-hc-h12-foo-bar').variants;

引数(parameters)

引数なし

引数はありません

戻り値(return)

string[]

このプロパティは、ロケールオブジェクトに定義されているバリアントの配列を返します。バリアントとは、言語の特定の地域や文体を示すための追加情報のことです。

関連コンテンツ

関連プログラミング言語