toLocaleString 方法

更新:2007 年 11 月

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

function toLocaleString() : String

备注

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

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

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

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

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

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

说明:

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

示例

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

function toLocaleStringArray() {
   // Declare variables.
   var myArray = new Array(6);
   var i;
   // Initialize string.
   var s = "The array contains: ";
   // Populate array with values.
   for(i = 0;i < 7; i++)
   {
      // Make value same as index.
      myArray[i] = i;
   }
   s += myArray.toLocaleString();
   return(s);
}
function toLocaleStringDate() {
   // Declare variables.
   var d = new Date();
   var s = "Current date setting is ";
   // Convert to current locale.
   s += d.toLocaleString();
   return(s);
}
function toLocaleStringNumber() {
   var n = Math.PI;
   var s = "The value of Pi is: ";
   s+= n.toLocaleString();
   return(s);
}

要求

版本 1

应用于:

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

请参见

其他资源

Visual Basic 和 Visual C# 项目扩展性方法