Intl.Locale.prototype.toString()

Baseline 已广泛支持

此功能已成熟,并可在许多设备和浏览器版本上使用。自 2020 年 9 月起,所有浏览器均已提供此功能。

toString() 方法用于 Intl.Locale 实例,它会返回此 Locale 的完整 locale 标识符字符串

试一试

const french = new Intl.Locale("fr-Latn-FR", {
  calendar: "gregory",
  hourCycle: "h12",
});
const korean = new Intl.Locale("ko-Kore-KR", {
  numeric: true,
  caseFirst: "upper",
});

console.log(french.toString());
// Expected output: "fr-Latn-FR-u-ca-gregory-hc-h12"

console.log(korean.toString());
// Expected output: "ko-Kore-KR-u-kf-upper-kn"

语法

js
toString()

参数

无。

返回值

locale的 Unicode locale 标识符字符串。

描述

Locale 对象是 Unicode locale 标识符概念在 JavaScript 中的表示。关于特定 locale(语言、脚本、日历类型等)的信息可以编码在 locale 标识符字符串中。为了方便处理这些 locale 标识符,JavaScript 中引入了 Locale 对象。在 Locale 对象上调用 toString 方法会返回该特定 Locale 的标识符字符串。toString 方法允许将 Locale 实例作为参数传递给现有的 Intl 构造函数,进行 JSON 序列化,或在任何其他需要精确字符串表示的上下文中。

示例

使用 toString

js
const myLocale = new Intl.Locale("fr-Latn-FR", {
  hourCycle: "h12",
  calendar: "gregory",
});
console.log(myLocale.baseName); // Prints "fr-Latn-FR"
console.log(myLocale.toString()); // Prints "fr-Latn-FR-u-ca-gregory-hc-h12"

规范

规范
ECMAScript® 2026 国际化 API 规范
# sec-Intl.Locale.prototype.toString

浏览器兼容性

另见