String.prototype.toLocaleLowerCase()

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

toLocaleLowerCase() 方法用於將 String 值轉換為小寫,具體取決於任何特定於區域設定的大小寫對映。

試一試

const dotted = "İstanbul";

console.log(`EN-US: ${dotted.toLocaleLowerCase("en-US")}`);
// Expected output: "i̇stanbul"

console.log(`TR: ${dotted.toLocaleLowerCase("tr")}`);
// Expected output: "istanbul"

語法

js
toLocaleLowerCase()
toLocaleLowerCase(locales)

引數

locales 可選

一個帶有 BCP 47 語言標籤的字串,或者由這些字串組成的陣列。指定用於根據任何特定於區域設定的大小寫對映進行小寫轉換的區域設定。有關 locales 引數的一般形式和解釋,請參閱 Intl 主頁上的引數描述

與使用 locales 引數的其他方法不同,toLocaleLowerCase() 不允許區域設定匹配。因此,在檢查 locales 引數的有效性後,toLocaleLowerCase() 始終使用列表中的第一個區域設定(如果列表為空,則使用預設區域設定),即使該區域設定不受實現支援。

返回值

一個表示呼叫字串已根據任何特定於區域設定的大小寫對映轉換為小寫的字串。

描述

toLocaleLowerCase() 方法返回根據任何特定於區域設定的大小寫對映轉換為小寫的字串值。toLocaleLowerCase() 不會影響字串本身的值。在大多數情況下,這將產生與 toLowerCase() 相同的結果,但對於某些區域設定(如土耳其語),其大小寫對映不遵循 Unicode 中的預設大小寫對映,可能會有不同的結果。

示例

使用 toLocaleLowerCase()

js
"ALPHABET".toLocaleLowerCase(); // 'alphabet'

"\u0130".toLocaleLowerCase("tr") === "i"; // true
"\u0130".toLocaleLowerCase("en-US") === "i"; // false

const locales = ["tr", "TR", "tr-TR", "tr-u-co-search", "tr-x-turkish"];
"\u0130".toLocaleLowerCase(locales) === "i"; // true

規範

規範
ECMAScript® 2026 語言規範
# sec-string.prototype.tolocalelowercase
ECMAScript® 2026 國際化 API 規範
# sup-string.prototype.tolocalelowercase

瀏覽器相容性

另見