JavaScript 数组 toLocaleString() 方法

JavaScript toLocaleString() 语法

toLocaleString() 是 JavaScript 数组的一个方法。toLocaleString() 方法会返回一个字符串，该字符串由 “特定地理区域的分隔符” 进行分隔。

语法：

arr.toLocaleString(locales, options)

说明：

toLocaleString() 方法接收以下 2 个参数。

• locales（可选）：是一个字符串或字符串数组，表示用于格式化输出的语言环境（locale）。例如，"en-US"（美国英语）或 ["zh-CN", "en-US"]（中文，备用美国英语）。如果省略此参数，则使用运行时的默认语言环境。
• options（可选）：是一个对象，用于配置日期、时间、数字的格式化选项。这些选项会传递给每个元素的 toLocaleString() 方法。

实际上，String、Array、Number 等对象的 toLocaleString() 方法，都是继承自 Object.prototype.toLocaleString()，小伙伴们可以对比理解一下：

• JavaScript Object toLocaleString() 方法
• JavaScript String toLocaleString() 方法
• JavaScript Number toLocaleString() 方法

JavaScript toLocaleString() 摘要

JavaScript toLocaleString() 示例

接下来，我们通过几个简单的例子来讲解一下 JavaScript toLocaleString() 方法是如何使用的。

示例 1：toLocaleString() 基本用法

const arr = ["红", "绿", "蓝"]
const result = arr.toLocaleString();

console.log(result);
console.log(typeof(result));

运行结果如下。

红,绿,蓝
string

分析：

从结果可以看出，toLocaleString() 方法并不会改变原数组，而是返回一个字符串。

示例 2：toLocaleString() 指定语言环境和数字格式

const prices = [123.45, 6789.54];

// 指定为德语环境（de-DE），使用欧元货币格式
const euroPrices = prices.toLocaleString("de-DE", { style: "currency", currency: "EUR" });
console.log(`德语欧元格式: "${euroPrices}"`);

// 指定为印度英语环境（en-IN），使用印度卢比格式
const inrPrices = prices.toLocaleString("en-IN", { style: "currency", currency: "INR" });
console.log(`印度卢比格式: "${inrPrices}"`);

运行结果如下。

德语欧元格式: "123,45 €,6.789,54 €"
印度卢比格式: "₹123.45,₹6,789.54"

分析：

通过使用 toLocaleString() 的 locales 和 options 参数，我们可以对数字的格式进行精细控制，例如货币符号、小数位数和千位分隔符等。

示例 3：toString() 和 toLocaleString()

const arr = ["红", "绿", new Date()]

console.log(arr.toString());
console.log(arr.toLocaleString());

运行结果如下。

红,绿,Thu Nov 16 2025 22:28:43 GMT+0800 (中国标准时间)
红,绿,2025/11/16 22:28:43

分析：

在一般情况下，toString() 和 toLocaleString() 的输出结果是一样的。不过当数组元素是一个 Date 对象时，此时两者结果是不一样的。