toLocaleString 將字串、日期、數字、陣列等物件的本地化

落花看风雪發表於2024-03-30
字串陣列物件

toLocaleString() 是 JavaScript 中許多物件（包括 Number、Date 和陣列）的一個方法。這個方法返回一個字串，該字串表示該物件的本地化版本。這通常意味著它會考慮執行程式碼的環境的語言和地區設定，來生成一個更易讀或更符合當地習慣的字串表示。

對於 Number：

當對 Number 物件使用 toLocaleString() 方法時，它會返回一個表示該數字的字串，該字串的格式會考慮本地環境。

例如：

let num = 123456.789;  
console.log(num.toLocaleString()); // 輸出可能類似於 "123,456.789"，取決於地區設定

對於 Date：

當對 Date 物件使用 toLocaleString() 方法時，它會返回一個表示該日期的字串，該字串的格式會考慮本地環境。

例如：

let date = new Date();  
console.log(date.toLocaleString()); // 輸出可能類似於 "2023/10/23 14:30:00"，取決於地區設定

對於陣列：

當對陣列使用 toLocaleString() 方法時，它會將陣列的每個元素轉換為其本地化字串表示形式，並用本地特定的分隔符連線起來。

例如：

let arr = [123456.789, new Date()];  
console.log(arr.toLocaleString()); // 輸出可能類似於 "123,456.789, 2023/10/23 14:30:00"，取決於地區設定

自定義選項：

toLocaleString() 方法還可以接受一個選項物件，允許你更細粒度地控制輸出的格式。例如，你可以指定使用哪種語言，數字的格式（如千位分隔符和小數位數），日期的格式等。

注意事項：

  • toLocaleString() 的行為取決於執行程式碼的環境的本地設定。因此，在不同的瀏覽器或不同的作業系統上，輸出可能會有所不同。
  • 由於這種依賴本地設定的行為，當需要一致和可預測的格式化輸出時，可能更傾向於使用其他庫或手動格式化方法。

總之，toLocaleString() 是一個很有用的方法，可以幫助你生成符合當地文化和習慣的字串表示。但請注意其依賴本地設定的行為，並根據需要謹慎使用。

使用示例: toLocaleString("zh-CN", { style: "currency", currency: "CNY" })

這段程式碼在 JavaScript 中通常不是直接對數字（Number）物件呼叫的，因為 toLocaleString 方法並不接受字串作為第一個引數。這個方法通常用於 Number 或 Date 物件，以生成本地化的字串表示。對於 Number 物件，使用 toLocaleString 並傳入選項物件可以生成特定格式的本地化貨幣字串。

在你提供的例子中，"zh-CN" 表示中國的簡體中文環境，而選項物件 { style: "currency", currency: "CNY" } 指定了格式化的樣式為貨幣，並且貨幣種類為人民幣（CNY）。

不過，要正確地使用 toLocaleString 生成人民幣格式的字串，你應該首先有一個 Number 物件，代表你要格式化的金額。例如：

let amount = 1234.56; // 假設這是你要格式化的金額（以元為單位）  
let formattedAmount = amount.toLocaleString("zh-CN", { style: "currency", currency: "CNY" });  
console.log(formattedAmount); // 輸出可能類似於 "¥1,234.56"，取決於瀏覽器的實現和使用者的本地設定

在這個例子中，formattedAmount 將是一個字串，表示金額為1234.56元的人民幣，並且格式化為中國的本地化貨幣格式。注意，輸出的具體格式可能會因瀏覽器和作業系統的不同而略有差異，因為 toLocaleString 的行為取決於執行環境的本地化設定。

如果你嘗試直接使用類似 1234.56.toLocaleString("zh-CN", { style: "currency", currency: "CNY" }) 這樣的程式碼，JavaScript 會丟擲一個錯誤，因為 1234.56 是一個數字，而不是一個物件，因此它沒有 toLocaleString 方法。你需要先將它包裝成一個 Number 物件，或者確保你正在對一個具有 toLocaleString 方法的物件（如 Number 或 Date）使用該方法。

相關文章