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 物件

請參閱

其他資源

方法