Metode JavaScript Number toLocaleString()

Definisi dan penggunaan

toLocaleString() Mengembalikan angka dalam bentuk string menggunakan format bahasa lokal.

Format bahasa tergantung pengaturan area komputer Anda.

Contoh

Contoh 1

Menggunakan pengaturan area untuk memformat angka menjadi string:

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

Coba sendiri

Contoh 2

Menggunakan lingkungan bahasa khusus Finlandia untuk memformat angka menjadi string:

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

Coba sendiri

Contoh 3

Menggunakan lingkungan bahasa khusus Amerika Serikat untuk memformat angka menjadi string uang:

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

Coba sendiri

Contoh 4

Pergunakan options Parameter (objek) untuk memformat mata uang:

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

Coba sendiri

Contoh 5

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

Coba sendiri

Contoh 6

Gunakan lingkungan bahasa khusus JAPAN:

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

Coba sendiri

Grammar

number.toLocaleString(locales, options)

Parameter

Parameter Deskripsi
locales Pilihan. Format spesifik bahasa yang digunakan. Lihat tabel di bawah.
options Pilihan. Objek yang memiliki opsi format. Lihat tabel di bawah.

locales Nilai yang diterima parameter:

  • ar-SA Arab (Saudi Arabia)
  • bn-BD Bengali (Bangladesh)
  • bn-IN Bengali (India)
  • cs-CZ Czech (Republik Ceko)
  • da-DK Dansk (Denmark)
  • de-AT Jerman Austria
  • de-CH Jerman Swiss
  • de-DE Jerman standar (digunakan di Jerman)
  • el-GR Greek Modern
  • en-AU Inggris Australia
  • en-CA Inggris Kanada
  • en-GB Inggris Inggris
  • en-IE Inggris Irlandia
  • en-IN Inggris India
  • en-NZ Inggris Selandia Baru
  • en-US Inggris Amerika
  • en-ZA Inggris (Afrika Selatan)
  • es-AR Spanyol Argentina
  • es-CL Spanyol Chili
  • es-CO Spanyol Kolombia
  • es-ES Spanyol Kastilia (digunakan di bagian utara dan tengah Spanyol)
  • es-MX Spanyol Meksiko
  • es-US Spanyol Amerika
  • fi-FI Suomi (Finlandia)
  • fr-BE Prancis Belgia
  • fr-CA Prancis Kanada
  • fr-CH Prancis Swiss
  • fr-FR Prancis standar (terutama di Perancis)
  • he-IL Ibrani (Israel)
  • hi-IN Hindi (India)
  • hu-HU Budapestis (Hungaria)
  • id-ID Bahasa 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 lisan)
  • 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 Cina Daratan, tulisan berbahasa Tionghoa Sederhana
  • zh-HK Hong Kong, tulisan berbahasa Tionghoa
  • zh-TW Taiwan, tulisan berbahasa Tionghoa

options Pilihan yang diterima parameter:

Pilihan Nilai
currency Nilai yang sah: kode mata uang apapun (seperti "EUR", "USD", "INR", dll)
currencyDisplay

Nilai yang sah:

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

Nilai yang sah:

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

Nilai yang sah:

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

Nilai yang sah:

  • "true"(Baku)
  • "false"

Nilai kembalian

Tipe Deskripsi
String Mewakili string angka lokal.

Detil teknis

Nilai kembalian

Perwakilan string angka, yang ditentukan oleh implementasi, disesuaikan berdasarkan standar lokal, yang mungkin mempengaruhi tanda baca titik desimal atau tanda pemisah ribuan.

Dipancarkan

Eksepsi Deskripsi
TypeError Eksepsi yang diangkat ketika objek yang dipanggil bukan Number.

Dukungan browser

toLocaleString() Adalah fitur ECMAScript3 (ES3).

Seluruh peramban mendukung ES3 (JavaScript 1999) penuhnya:

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