CodePlayer

toLocaleString()函数用于将当前对象以字符串值的形式返回，该字符串的格式适合当前宿主环境的当前区域设置。

该方法属于Object对象，由于所有的对象都"继承"了Object的对象实例，因此几乎所有的实例对象都可以使用该方法。

所有主流浏览器均支持该函数。

语法

object.toLocaleString( )

返回值

toLocaleString()函数的返回值为String类型。返回当前对象的"本地化"字符串形式，以便于当前环境的用户辨识和使用。

JavaScript的许多内置对象都重写了该函数，以实现更适合自身的功能需要。

如果object是数组对象(Array)，则将每个数组元素转换为字符串，并将这些字符串之间以指定的分隔符拼接起来后返回，分隔符由当前宿主环境的当前区域设置决定(在中国大陆，分隔符一般为英文逗号,)。

如果object是日期/时间对象(Date)，toLocaleString()方法返回一个以当前区域设置的长默认格式编写的日期字符串。

• 对于公元 1601 和 9999 年之间的日期，其格式将根据用户在“控制面板”中选择的“区域设置”确定(Windows 7中为“控制面板”->“区域和语言”)。
• 对于此范围之外的日期，将使用toString()方法的默认格式。

如果object是数字对象(Number)，toLocaleString()产生一个表示该Number值的字符串，其格式对应于宿主环境的当前区域设置。

示例&说明

以下示例运行的宿主环境为Windows 7 简体中文旗舰版 64位，地点为中国大陆。不同的区域设置和语言设置，执行的输出结果可能不同。

// 数组
var array = ["CodePlayer", true, 12, -5];
document.writeln( array.toLocaleString() ); // CodePlayer,true,12,-5

// 日期
var date = new Date(2013, 7, 18, 23, 11, 59, 230);
document.writeln( date.toLocaleString() ); // 2013年8月18日 下午11:11:59

// 日期2
var date2 = new Date(1099, 7, 18, 23, 11, 59, 230);
document.writeln( date2.toLocaleString() ); // 1099年8月12日 下午11:17:51

// 数字
var num =  15.26540;
document.writeln( num.toLocaleString() ); // 15.265

// 布尔
var bool = true;
document.writeln( bool.toLocaleString() ); // true

// Object
var obj = {name: "张三", age: 18};
document.writeln( obj.toLocaleString() ); // [object Object]

// HTML DOM 节点
var eles = document.getElementsByTagName("body");
document.writeln( eles.toLocaleString() ); // [object NodeList]
document.writeln( eles[0].toLocaleString() ); // [object HTMLBodyElement]

运行代码