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 alocale
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 | Status | Comment |
---|---|---|
ECMAScript 3rd Edition (ECMA-262) | Standard | Initial definition. Implemented in JavaScript 1.2. |
ECMAScript 5.1 (ECMA-262) String.prototype.toLocaleLowerCase |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) String.prototype.toLocaleLowerCase |
Standard | |
ECMAScript Latest Draft (ECMA-262) String.prototype.toLocaleLowerCase |
Draft | |
ECMAScript Internationalization API 4.0 (ECMA-402) String.prototype.toLocaleLowerCase |
Draft | ES Intl 2017 added the locale parameter. |
浏览器兼容性
We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains.
Find out how you can help!
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |