Intl.Locale.prototype.language

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2020年9月.

language は Intl.Locale インスタンスのアクセサープロパティで、このロケールに関連付けられた言語を返します。

解説

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

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

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

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

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

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

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

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

Specification

Enable JavaScript to view this browser compatibility table.

Was this page helpful to you?

Yes No

This page was last modified on 2026年2月21日 by MDN contributors.