String.prototype.toLocaleLowerCase()

**toLocaleLowerCase()**方法根据任何指定区域语言环境设置的大小写映射,返回调用字符串被转换为小写的格式。

语法

str.toLocaleLowerCase()
str.toLocaleLowerCase(locale)
str.toLocaleLowerCase([locale, locale, ...])

参数

locale 可选

参数 locale 指明要转换成小写格式的特定语言区域。 如果以一个数组 Array 形式给出多个 locales, 最合适的地区将被选出来应用(参见best available locale)。默认的 locale 是主机环境的当前区域 (locale) 设置。

返回值

根据任何特定于语言环境的案例映射规则将被调用字串转换成小写格式的一个新字符串。

Exceptions

  • A RangeError ("invalid language tag: xx_yy") is thrown if a locale argument isn't a valid language tag.
  • A TypeError ("invalid element in locales argument") is thrown if an array element isn't of type string.

描述

toLocaleLowerCase() 方法返回根据任意区域语言大小写映射集而转换成小写格式的字符串。toLocaleLowerCase() 并不会影响字符串原本的值。在大多数情况下,该方法和调用 toLowerCase()的结果相同,但是在某些区域环境中,比如土耳其语,它的大小写映射并不遵循在 Unicode 中的默认的大小写映射,因此会有一个不同的结果。

例子

使用 toLocaleLowerCase()

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

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

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

规范

Specification
ECMAScript Language Specification
# sec-string.prototype.tolocalelowercase
ECMAScript Internationalization API Specification
# sup-string.prototype.tolocalelowercase

浏览器兼容性

BCD tables only load in the browser

参阅