Intl.Locale.prototype.language

解説

言語はロケールの中核的な特徴の一つです。 Unicode 仕様書では、ロケールの言語識別子を言語と地域を合わせたものとして扱います（イギリス英語とアメリカ英語などの方言や変化形を区別するためです）。Intl.Locale の language プロパティは、ロケールの言語サブタグを厳密に返します。

language プロパティの値は、ロケール識別子の最初の部分、または Intl.Locale() コンストラクターの language オプションを通じて、コンストラクション時に設定されます。両方が存在する場合、後者が優先されます。

language の設定アクセサーは undefined です。このプロパティを直接変更することはできません。

例

他のロケールサブタグと同様に、言語はロケール文字列を介して、またはコンストラクターへの設定オブジェクト引数として、Intl.Locale オブジェクトに追加できます。

ロケール識別子の文字列引数で言語を設定

有効な Unicode 言語識別子となるためには、文字列は言語サブタグで始めなければなりません。 Locale コンストラクターの主要な引数には、有効な Unicode ロケール識別子がなければならないので、コンストラクターを使用する際には必ず言語サブタグを持つ識別子を渡さなければなりません。

const locale = new Intl.Locale("en-Latn-US");
console.log(locale.language); // "en" と表示

構成オブジェクトにより言語を上書き

言語サブタグは指定する必要がありますが、Intl.Locale() コンストラクターは構成オブジェクトを取り、これを用いて言語サブタグを上書きすることができます。

const locale = new Intl.Locale("en-Latn-US", { language: "es" });
console.log(locale.language); // "es"

仕様書

ブラウザーの互換性

関連情報

• Intl.Locale
• Unicode language subtag（Unicode ロケールデータマークアップ言語仕様書）