大网数据广告活动
Web 标准与前端开发

String.prototype.toLocaleUpperCase()

· 52CE 我爱测

String 的 **`toLocaleUpperCase()`** 方法会根据特定区域设置的大小写映射规则,将字符串转换为大写形式并返回。

String 的 toLocaleUpperCase() 方法会根据特定区域设置的大小写映射规则,将字符串转换为大写形式并返回。

JavaScript Demo: String.toLocaleUpperCase()

const city = "istanbul";

console.log(city.toLocaleUpperCase("en-US"));
// Expected output: "ISTANBUL"

console.log(city.toLocaleUpperCase("TR"));
// Expected output: "İSTANBUL"

语法

toLocaleUpperCase()
toLocaleUpperCase(locales)

参数

  • locales
    • : 一个带有 BCP 47 语言标签的字符串,或者是这种字符串的数组。指示要根据特定区域设置的大小写映射规则进行转换的区域设置。有关 locales 参数的一般形式和解释,请参阅 Intl 主页上的参数描述。

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

返回值

一个新的字符串,表示调用字符串根据特定区域设置的大小写映射规则转换得到的大写形式。

描述

toLocaleUpperCase() 方法返回根据特定区域设置的大小写映射规则将字符串转换为大写形式的值。toLocaleUpperCase() 不会影响字符串本身的值。在大多数情况下,这将产生与 String.prototype.toUpperCase() 相同的结果,但对于某些区域设置(例如土耳其语),它们的大小写映射与 Unicode 的默认映射不同,可能会得到不同的结果。

还要注意,转换不一定是一对一的字符映射,因为某些字符在转换为小写形式时可能会产生两个(甚至更多)字符。因此,结果字符串的长度可能与输入长度不同。这也意味着转换是不稳定的,因此下面的例子可能返回 false: x.toLocaleLowerCase() === x.toLocaleUpperCase().toLocaleLowerCase()

示例

使用 toLocaleUpperCase()

"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'

规范

浏览器兼容性

参见

  • String.prototype.toLocaleLowerCase()
  • String.prototype.toLowerCase()
  • String.prototype.toUpperCase()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。