String.prototype.toLocaleLowerCase()

基线 广泛可用

此功能已完善,可在许多设备和浏览器版本中使用。它自以下时间起在浏览器中可用 2017 年 9 月.

toLocaleLowerCase()方法String值返回此字符串转换为小写,根据任何特定于区域设置的大小写映射。

试一试

语法

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 语言规范
# sec-string.prototype.tolocalelowercase
ECMAScript 国际化 API 规范
# sup-string.prototype.tolocalelowercase

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅