Intl.Locale.prototype.language

Baseline 已廣泛支援

此功能已成熟,並可在許多裝置和瀏覽器版本上使用。自 2020 年 9 月起,所有瀏覽器均已提供此功能。

language 訪問器屬性是 Intl.Locale 例項的一部分,用於返回與此區域設定關聯的語言。

描述

語言是區域設定的核心屬性之一。Unicode 規範將區域設定的語言識別符號視為語言和地區(以區分方言和變體,例如,英式英語與美式英語)。Intl.Localelanguage 屬性嚴格返回該區域設定的語言子標籤。

language 屬性的值在構造時設定,可以透過區域設定識別符號的第一部分,或者透過 Intl.Locale() 建構函式的 language 選項來設定。如果兩者都存在,則後者具有優先權。

language 的 set 訪問器為 undefined。您不能直接修改此屬性。

示例

與其他區域設定子標籤一樣,語言可以透過區域設定字串,或者透過建構函式的配置物件引數新增到 Intl.Locale 物件中。

透過區域設定字串設定語言

為了成為有效的 Unicode 區域設定識別符號,字串必須以語言子標籤開頭。Intl.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"

規範

規範
ECMAScript® 2026 國際化 API 規範
# sec-Intl.Locale.prototype.language

瀏覽器相容性

另見