String.prototype.toLocaleUpperCase()

基线 广泛可用

此功能已完善，并在许多设备和浏览器版本中运行。它自 2017 年 9 月.

报告反馈

试一试

语法

toLocaleUpperCase() 方法是 String 值的一种方法，它根据任何特定于区域设置的大小写映射返回转换为大写的此字符串。
toLocaleUpperCase()
toLocaleUpperCase(locales)

js

locales 可选

包含 BCP 47 语言标签的字符串，或此类字符串的数组。指示要用于转换为大写的区域设置，以便根据任何特定于区域设置的大小写映射进行转换。有关 locales 参数的通用形式和解释，请参见 Intl 主页上的参数说明。

与使用 locales 参数的其他方法不同，toLocaleUpperCase() 不允许区域设置匹配。因此，在检查 locales 参数的有效性后，toLocaleUpperCase() 始终使用列表中的第一个区域设置（如果列表为空，则使用默认区域设置），即使此区域设置不受实现支持。

返回值

一个新的字符串，表示根据任何特定于区域设置的大小写映射转换为大写的调用字符串。

描述

toLocaleUpperCase() 方法返回根据任何特定于区域设置的大小写映射转换为大写的字符串的值。toLocaleUpperCase() 不会影响字符串本身的值。在大多数情况下，这将产生与 toUpperCase() 相同的结果，但对于某些区域设置（例如土耳其语），其大小写映射不遵循 Unicode 中的默认大小写映射，可能会产生不同的结果。

另外请注意，转换不一定是 1:1 的字符映射，因为某些字符在转换为大写时可能会产生两个（甚至更多）字符。因此，结果字符串的长度可能与输入长度不同。这也意味着转换不稳定，因此例如以下内容可能会返回 false：x.toLocaleLowerCase() === x.toLocaleUpperCase().toLocaleLowerCase()

示例

使用 toLocaleUpperCase()

toLocaleUpperCase() 方法是 String 值的一种方法，它根据任何特定于区域设置的大小写映射返回转换为大写的此字符串。
"alphabet".toLocaleUpperCase(); // 'ALPHABET'

"Gesäß".toLocaleUpperCase(); // 'GESÄSS'

"i\u0307".toLocaleUpperCase("lt-LT"); // 'I'

const locales = ["lt", "LT", "lt-LT", "lt-u-co-phonebk", "lt-x-lietuva"];
"i\u0307".toLocaleUpperCase(locales); // 'I'

规范

规范
ECMAScript 语言规范
# sec-string.prototype.tolocaleuppercase
ECMAScript 国际化 API 规范
# sup-string.prototype.tolocaleuppercase

浏览器兼容性

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

另请参阅