JavaScript Number toLocaleString() 方法

定义和用法

toLocaleString() 使用本地语言格式将数字作为字符串返回。

语言格式取决于您计算机上的区域设置。

实例

例子 1

使用区域设置将数字格式化为字符串：

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

亲自试一试

例子 2

使用芬兰的特定语言环境将数字格式化为字符串：

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

亲自试一试

例子 3

使用美国的特定语言环境将数字格式化为货币字符串：

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

亲自试一试

例子 4

使用 options 参数（对象）进行货币格式化：

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

亲自试一试

例子 5

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

亲自试一试

例子 6

使用 JAPAN 的特定语言环境：

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

亲自试一试

语法

number.toLocaleString(locales, options)

参数

参数 Deskripsi
locales 可选。要使用的语言特定格式。请参见下表。
options 可选。拥有格式选项的对象。请参见下表。

locales 参数可接受的值：

  • ar-SA 阿拉伯语（沙特阿拉伯）
  • bn-BD 孟加拉语（孟加拉国）
  • bn-IN 孟加拉语（印度）
  • cs-CZ 捷克语（捷克共和国）
  • da-DK 丹麦语（丹麦）
  • de-AT 奥地利德语
  • de-CH “瑞士”德语
  • de-DE 标准德语（在德国使用）
  • el-GR 现代希腊语
  • en-AU 澳大利亚英语
  • en-CA 加拿大英语
  • en-GB 英式英语
  • en-IE 爱尔兰英语
  • en-IN 印度英语
  • en-NZ 新西兰英语
  • en-US 美国英语
  • en-ZA 英语（南非）
  • es-AR 阿根廷西班牙语
  • es-CL 智利西班牙语
  • es-CO 哥伦比亚西班牙语
  • es-ES 卡斯蒂利亚西班牙语（在西班牙中北部使用）
  • es-MX 墨西哥西班牙语
  • es-US 美国西班牙语
  • fi-FI 芬兰语（芬兰）
  • fr-BE 比利时法语
  • fr-CA 加拿大法语
  • fr-CH “瑞士”法语
  • fr-FR 标准法语（尤其是在法国）
  • he-IL 希伯来语（以色列）
  • hi-IN 印地语（印度）
  • hu-HU 匈牙利语（匈牙利）
  • id-ID Indonesia (Indonesia)
  • it-CH “Swiss” Itali
  • it-IT Itali standar (digunakan di Italia)
  • ja-JP Jepang (Jepang)
  • ko-KR Korea (Korea Selatan)
  • nl-BE Belanda Belgia
  • nl-NL Belanda standar (Belanda)
  • no-NO Norwegia (Norwegia)
  • pl-PL Polandia (Polandia)
  • pt-BR Portugis Brazil
  • pt-PT Portugis Eropa (Portugis tulisan dan berbicara)
  • ro-RO Rumania (Rumania)
  • ru-RU Rusia (Federasi Rusia)
  • sk-SK Slovak (Slovakia)
  • sv-SE Swedia (Swedia)
  • ta-IN Tamil India
  • ta-LK Tamil Sri Lanka
  • th-TH Thai (Thailand)
  • tr-TR Turki (Turki)
  • zh-CN Tiongkok Daratan, huruf Tionghua berbahasa China
  • zh-HK Hong Kong, huruf Tionghua berbahasa China
  • zh-TW Taiwan, huruf Tionghua berbahasa China

options Pilihan yang diterima parameter:

Pilihan Nilai
currency Nilai sah: setiap kode mata uang (seperti "EUR", "USD", "INR" dsb)
currencyDisplay

Nilai sah:

  • "symbol"(Baku)
  • "code"
  • "name"
localeMatcher

Nilai sah:

  • "best-fit"(Baku)
  • "lookup"
maximumFractionDigits Angka dari 0 hingga 20 (baku adalah 3)
maximumSignificantDigits Angka dari 1 hingga 21 (baku adalah 21)
minimumFractionDigits Angka dari 0 hingga 20 (baku adalah 3)
minimumIntegerDigits Angka dari 1 hingga 21 (baku adalah 1)
minimumSignificantDigits Angka dari 1 hingga 21 (baku adalah 21)
style

Nilai sah:

  • "currency"
  • "decimal"(Baku)
  • "percent"
useGrouping

Nilai sah:

  • "true"(Baku)
  • "false"

Nilai kembalian

Tipe Deskripsi
Teks Menunjukkan teks angka lokal.

Detil teknis

Nilai kembalian

Perwakilan teks angka, diputuskan oleh implementasi, disesuaikan menurut aturan lokal, mungkin mempengaruhi tanda baca titik desimal atau pemisah ribuan.

Luncurkan

Ekssepsi Deskripsi
TypeError Tanggung jawab eksepsi bila objek yang dipanggil bukan Number.

Dukungan pereksa

toLocaleString() Adalah ciri ECMAScript3 (ES3).

Semua pelayar mendukung ES3 (JavaScript 1999) penuhnya:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Dukungan Dukungan Dukungan Dukungan Dukungan Dukungan