Intl.Locale.prototype.region

Baseline 已廣泛支援

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

region 訪問器屬性是 Intl.Locale 例項的一部分,它返回與此區域設定相關的世界區域(通常是一個國家)。

描述

區域是區域設定的核心屬性之一。它允許區分同一語言在不同國家之間的差異。例如,英語在英國和美利堅合眾國都有使用,但這兩個國家在拼寫和其他語言慣例上存在差異。瞭解區域設定的區域有助於 JavaScript 程式設計師確保他們的網站和應用程式的內容在世界不同地區檢視時能夠正確顯示。

region 屬性的值在構造時設定,可以透過區域識別符號中 script 後面的部分,也可以透過 Intl.Locale() 建構函式的 region 選項來設定。如果兩者都存在,後者具有優先權;如果兩者都不存在,則該屬性的值為 undefined

region 的設定訪問器為 undefined。您不能直接更改此屬性。

示例

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

透過區域字串新增區域

區域(如果存在)是有效的 Unicode 語言識別符號字串的第三部分(如果存在 script,則為第二部分,否則為第三部分),可以新增到傳遞給 Intl.Locale() 建構函式的初始區域字串中。請注意,區域不是區域識別符號的必需部分。

js
const locale = new Intl.Locale("en-Latn-US");
console.log(locale.region); // "US"

透過配置物件引數新增區域

Intl.Locale() 建構函式有一個可選的配置物件引數。將配置物件的 region 屬性設定為您想要的區域,然後將其傳遞給建構函式。

js
const locale = new Intl.Locale("fr-Latn", { region: "FR" });
console.log(locale.region); // "FR"

規範

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

瀏覽器相容性

另見