toLocaleString 方法

以字符串值的形式返回一个值,该值适合于宿主环境的当前区域设置。

function toLocaleString() : String

备注

对于 Array 对象,将数组元素转换为字符串并将这些字符串连接起来后返回,每个字符串由宿主环境的当前区域设置所指定的列表分隔符分隔。

对于 Date 对象,toLocaleString 方法返回一个 String 对象,此对象包含以当前区域设置的长默认格式编写的日期。

  • 对于公元 1601 和 9999 之间的日期,其格式将根据用户在“控制面板”中选择的“区域设置”确定。

  • 对于此范围之外的日期,将使用 toString 方法的默认格式。

对于 Number 对象,toLocaleString 产生一个表示 Number 值的字符串值,其格式对应于宿主环境的当前区域设置。

对于 Object 对象,使用 ToLocaleString 为所有对象提供一个通用的 toLocaleString 功能,即使这些对象可能并不使用此功能。

提示

toLocaleString 应当仅用于向用户显示结果;决不可将它用作脚本中计算的基础,因为返回的结果因计算机而异。

示例

下面的客户端示例阐释了使用 Array、Date 和 Number 对象的 toLocaleString 方法的用法。

function toLocaleStringArray() {
   // Populate an array with values.
   // Each value is the same as the index.
   var myArray = new Array();
   for(var i = 0; i <= 6; i++)
   {
      myArray[i] = i;
   }

   var s = myArray.toLocaleString();
   return(s);
}

function toLocaleStringDate() {
   var d = new Date();
   var s = d.toLocaleString();
   return(s);
}

function toLocaleStringNumber() {
   var n = Math.PI;
   var s = n.toLocaleString();
   return(s);
}

要求

版本 1

应用于:

Array 对象| Date 对象| Number 对象| Object 对象

请参见

其他资源

方法