Phương thức JavaScript Number toLocaleString()

Định nghĩa và cách sử dụng

toLocaleString() Trả về số dưới dạng chuỗi bằng cách sử dụng định dạng ngôn ngữ địa phương.

Định dạng ngôn ngữ phụ thuộc vào cài đặt vùng của máy tính của bạn.

Mô hình

Ví dụ 1

Sử dụng cài đặt vùng để định dạng số thành chuỗi:

let num = 1000000;
let text = num.toLocaleString();

Thử nghiệm cá nhân

Ví dụ 2

Sử dụng môi trường ngôn ngữ đặc thù của Phần Lan để định dạng số thành chuỗi:

let num = 1000000;
let text = num.toLocaleString("fi-FI");

Thử nghiệm cá nhân

Ví dụ 3

Sử dụng môi trường ngôn ngữ đặc thù của Mỹ để định dạng số thành chuỗi tiền tệ:

let num = 1000000;
let text = num.toLocaleString("en-US", {style:"currency", currency:"USD"});

Thử nghiệm cá nhân

Ví dụ 4

Sử dụng options Parameter (object) để định dạng tiền tệ:

let num = new Number(1000000);
const myObj = {
  style: "currency",
  currency: "EUR"
}
let text = num.toLocaleString("en-GB", myObj);

Thử nghiệm cá nhân

Ví dụ 5

let num = new Number(1000000);
let text = num.toLocaleString("en-GB", {style:"currency", currency:"EUR"});

Thử nghiệm cá nhân

Ví dụ 6

Sử dụng môi trường ngôn ngữ đặc biệt của JAPAN:

let num = 1000000;
let text = num.toLocaleString("ja-JP", {style:"currency", currency:"JPY"});

Thử nghiệm cá nhân

Grammar

number.toLocaleString(locales, options)

Parameter

Parameter Mô tả
locales Chọn. Định dạng ngôn ngữ đặc biệt cần sử dụng. Xem bảng dưới đây.
options Chọn. Đối tượng có tùy chọn định dạng. Xem bảng dưới đây.

locales Giá trị có thể chấp nhận được:

  • ar-SA Tiếng Ả Rập (Saudi Arabia)
  • bn-BD Tiếng Bengal (Bangladesh)
  • bn-IN Tiếng Bengal (Ấn Độ)
  • cs-CZ Tiếng Séc (Cộng Hòa Séc)
  • da-DK Tiếng Đan Mạch (Đan Mạch)
  • de-AT Tiếng Đức Áo
  • de-CH Tiếng Đức Thụy Sĩ
  • de-DE Tiếng Đức tiêu chuẩn (sử dụng ở Đức)
  • el-GR Tiếng Hy Lạp hiện đại
  • en-AU Tiếng Anh ở Úc
  • en-CA Tiếng Anh ở Canada
  • en-GB Tiếng Anh ở Anh
  • en-IE Tiếng Anh ở Ireland
  • en-IN Tiếng Anh ở Ấn Độ
  • en-NZ Tiếng Anh ở New Zealand
  • en-US Tiếng Anh ở Mỹ
  • en-ZA Tiếng Anh (Nam Phi)
  • es-AR Tiếng Tây Ban Nha ở Argentina
  • es-CL Tiếng Tây Ban Nha ở Chile
  • es-CO Tiếng Tây Ban Nha ở Colombia
  • es-ES Tiếng Tây Ban Nha Castilla (sử dụng ở miền bắc và trung bộ Tây Ban Nha)
  • es-MX Tiếng Tây Ban Nha ở Mexico
  • es-US Tiếng Tây Ban Nha ở Mỹ
  • fi-FI Tiếng Phần Lan (Phần Lan)
  • fr-BE Tiếng Pháp Bỉ
  • fr-CA Tiếng Pháp Canada
  • fr-CH Tiếng Pháp Thụy Sĩ
  • fr-FR Tiếng Pháp tiêu chuẩn (nhất là ở Pháp)
  • he-IL Tiếng Hebrew (Đài Loan)
  • hi-IN Tiếng Ả Rập (Ý Đắc La)
  • hu-HU NgữHungGari (Hungary)
  • id-ID Tiếng Indonesia (Indonesia)
  • it-CH “Swiss” Italian
  • it-IT Tiếng Ý (Ý)
  • ja-JP Tiếng Nhật (Nhật Bản)
  • ko-KR Tiếng Hàn (Cộng hòa Dân chủ Nhân dân Triều Tiên)
  • nl-BE Tiếng Hà Lan (Bỉ)
  • nl-NL Tiếng Hà Lan (Hà Lan)
  • no-NO Tiếng Na Uy (Na Uy)
  • pl-PL Tiếng Ba Lan (Ba Lan)
  • pt-BR Tiếng Bồ Đào Nha (Brasil)
  • pt-PT Tiếng Bồ Đào Nha (Portugal, cả văn bản viết và nói)
  • ro-RO Tiếng Romania (Romania)
  • ru-RU Tiếng Nga (Liên bang Nga)
  • sk-SK Tiếng Slovakia (Slovakia)
  • sv-SE Tiếng Thụy Điển (Thụy Điển)
  • ta-IN Tiếng Tamil (Ấn Độ)
  • ta-LK Tiếng Tamil (Sri Lanka)
  • th-TH Tiếng Thái (Thái Lan)
  • tr-TR Tiếng Thổ Nhĩ Kỳ (Thổ Nhĩ Kỳ)
  • zh-CN Trung Quốc đại lục, chữ Hán giản
  • zh-HK Hồng Kông, chữ Hán phức
  • zh-TW Đài Loan, chữ Hán phức

options Tùy chọn được chấp nhận bởi tham số:

Tùy chọn Giá trị
currency Giá trị hợp lệ: bất kỳ mã tiền tệ nào (như "EUR", "USD", "INR" v.v.).
currencyDisplay

Giá trị hợp lệ:

  • "symbol"(Mặc định)
  • "code"
  • "name"
localeMatcher

Giá trị hợp lệ:

  • "best-fit"(Mặc định)
  • "lookup"
maximumFractionDigits Số từ 0 đến 20 (mặc định là 3)
maximumSignificantDigits Số từ 1 đến 21 (mặc định là 21)
minimumFractionDigits Số từ 0 đến 20 (mặc định là 3)
minimumIntegerDigits Số từ 1 đến 21 (mặc định là 1)
minimumSignificantDigits Số từ 1 đến 21 (mặc định là 21)
style

Giá trị hợp lệ:

  • "currency"
  • "decimal"(Mặc định)
  • "percent"
useGrouping

Giá trị hợp lệ:

  • "true"(Mặc định)
  • "false"

Giá trị trả về

Loại Mô tả
Chuỗi Biểu diễn chuỗi số địa phương.

Chi tiết kỹ thuật

Giá trị trả về

Biểu diễn chuỗi số, do thực hiện quyết định, định dạng theo quy định địa phương, có thể ảnh hưởng đến dấu phẩy hoặc dấu phân cách hàng ngàn.

Ném

Lỗi Mô tả
TypeError Lỗi khi gọi phương thức đối tượng không phải là Number.

Hỗ trợ của trình duyệt

toLocaleString() Là tính năng của ECMAScript3 (ES3).

Tất cả các trình duyệt đều hỗ trợ hoàn toàn ES3 (JavaScript 1999):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Hỗ trợ Hỗ trợ Hỗ trợ Hỗ trợ Hỗ trợ Hỗ trợ