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

浏览器兼容性

另见