Metoda JavaScript Number toLocaleString()

Definicja i użycie

toLocaleString() Zwraca liczbę jako ciąg znaków w formacie lokalnym.

Format językowy zależy od ustawień regionalnych na komputerze.

Przykład

Przykład 1

Używając ustawień regionalnych, formatuje liczbę jako ciąg znaków:

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

Spróbuj sam

Przykład 2

Używając specyficznego środowiska językowego Finlandii, formatuje liczbę jako ciąg znaków:

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

Spróbuj sam

Przykład 3

Używając specyficznego środowiska językowego Stanów Zjednoczonych, formatuje liczbę jako ciąg znaków w formie waluty:

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

Spróbuj sam

Przykład 4

Użycie options Formatowanie waluty parametrami (obiekt):

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

Spróbuj sam

Przykład 5

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

Spróbuj sam

Przykład 6

Użycie specyficznego środowiska językowego JAPONII:

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

Spróbuj sam

Gramatyka

number.toLocaleString(locales, options)

Parametry

Parametry Opis
locales Opcjonalne. Językowy format używany. Proszę zobaczyć tabelę poniżej.
options Opcjonalne. Obiekt z opcjami formatowania. Proszę zobaczyć tabelę poniżej.

locales Dopuszczalne wartości parametrów:

  • ar-SA Arabski (Saudi Arabia)
  • bn-BD Bengalski (Bangladesz)
  • bn-IN Bengalski (Indie)
  • cs-CZ Czeski (Czechy)
  • da-DK Duński (Dania)
  • de-AT Niemiecki austriacki
  • de-CH Niemiecki "Szwajcarski"
  • de-DE Standardowy język niemiecki (używany w Niemczech)
  • el-GR Nowożytne greckie
  • en-AU Angielski australijski
  • en-CA Angielski kanadyjski
  • en-GB Angielski brytyjski
  • en-IE Angielski irlandzki
  • en-IN Angielski indyjski
  • en-NZ Angielski nowozelandzki
  • en-US Angielski amerykański
  • en-ZA Angielski (RPA)
  • es-AR Hiszpański argentyński
  • es-CL Hiszpański chilijski
  • es-CO Hiszpański kolumbijski
  • es-ES Hiszpański kastylijski (używany w środku i na północy Hiszpanii)
  • es-MX Hiszpański meksykański
  • es-US Hiszpański amerykański
  • fi-FI Finlandzki (Finlandia)
  • fr-BE Francuski belgijski
  • fr-CA Francuski kanadyjski
  • fr-CH Francuski "Szwajcarski"
  • fr-FR Standardowy język francuski (szczególnie we Francji)
  • he-IL Hebrajski (Izrael)
  • hi-IN Hindi (Indie)
  • hu-HU Węgierski (Węgry)
  • id-ID Indonezyjski (Indonezja)
  • it-CH Włoski "Szwajcaria"
  • it-IT Standardowy włoski (używany w Włoszech)
  • ja-JP Japoński (Japonia)
  • ko-KR Koreański (Republika Korei)
  • nl-BE Holenderski belgijski
  • nl-NL Standardowy holenderski (holenderski)
  • no-NO Norweski (Norwegia)
  • pl-PL Polski (Polska)
  • pt-BR Brazylijski portugalski
  • pt-PT Europejski portugalski (portugalski pisany i mówiony)
  • ro-RO Rumuński (Rumunia)
  • ru-RU Rosyjski ( Federacja Rosyjska )
  • sk-SK Słowacki (Słowacja)
  • sv-SE Szwedzki (Szwecja)
  • ta-IN Indyjski tamilski
  • ta-LK Sri Lankijski tamilski
  • th-TH Tajski (Tajlandia)
  • tr-TR Turecki (Turcja)
  • zh-CN Chiny kontynentalne, prostsze chińskie pismo
  • zh-HK Hongkong, złożone chińskie pismo
  • zh-TW Tajwan, złożone chińskie pismo

options Opcje akceptowane przez parametr:

Opcje Wartość
currency Dopuszczalne wartości: dowolny kod waluty (np. "EUR", "USD", "INR" itp.)
currencyDisplay

Dopuszczalne wartości:

  • "symbol"(domyślnie)
  • "code"
  • "name"
localeMatcher

Dopuszczalne wartości:

  • "best-fit"(domyślnie)
  • "lookup"
maximumFractionDigits Numer od 0 do 20 (domyślnie 3)
maximumSignificantDigits Numer od 1 do 21 (domyślnie 21)
minimumFractionDigits Numer od 0 do 20 (domyślnie 3)
minimumIntegerDigits Numer od 1 do 21 (domyślnie 1)
minimumSignificantDigits Numer od 1 do 21 (domyślnie 21)
style

Dopuszczalne wartości:

  • "currency"
  • "decimal"(domyślnie)
  • "percent"
useGrouping

Dopuszczalne wartości:

  • "true"(domyślnie)
  • "false"

Zwrócona wartość

Typ Opis
Ciąg znaków Ciąg znaków reprezentujący lokalny format liczby.

Techniczne szczegóły

Zwrócona wartość

Ciąg znaków reprezentujący liczbę, formatowanie zależy od implementacji, formatowanie zgodne z lokalnymi normami, może wpływać na znaki przecinka lub przecinka tysięcznego.

Wyrzuć

Wyjątek Opis
TypeError Wyjątek wyrzucony, gdy wywoływany obiekt nie jest Number.

Obsługa przeglądarki

toLocaleString() To ECMAScript3 (ES3) cecha.

Wszystkie przeglądarki obsługują w pełni ES3 (JavaScript 1999):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Wsparcie Wsparcie Wsparcie Wsparcie Wsparcie Wsparcie