JavaScript Number toLocaleString() methode

Definitie en gebruik

toLocaleString() Gebruik de lokale taalindeling om cijfers als string terug te geven.

De taalindeling hangt af van de taalinstellingen op uw computer.

Voorbeeld

Voorbeeld 1

Gebruik de taalinstellingen om cijfers te formatteren tot een string:

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

Probeer het zelf

Voorbeeld 2

Gebruik de specifieke taalomgeving van Finland om cijfers te formatteren tot een string:

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

Probeer het zelf

Voorbeeld 3

Gebruik de specifieke taalomgeving van de Verenigde Staten om cijfers te formatteren tot een munteenheid als string:

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

Probeer het zelf

Voorbeeld 4

Gebruik opties Parameter (object) voor valuta-opmaak:

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

Probeer het zelf

Voorbeeld 5

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

Probeer het zelf

Voorbeeld 6

Gebruik het specifieke taalgebied van JAPAN:

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

Probeer het zelf

Grammar

number.toLocaleString(locales, opties)

Parameter

Parameter beschrijving
locales Optioneel. Taalgebonden opmaak die gebruikt wordt. Zie tabel hieronder.
opties Optioneel. Object met opmaakopties. Zie tabel hieronder.

locales Waarde van het parameter die acceptabel is:

  • ar-SA Arabisch (Saudi-Arabië)
  • bn-BD Bengali (Bangladesh)
  • bn-IN Bengali (India)
  • cs-CZ Tsjechisch (Tsjechië)
  • da-DK Deens (Denemarken)
  • de-AT Oostenrijks Duits
  • de-CH “Zwitserse” Duits
  • de-DE Standaard Duits (gebruikt in Duitsland)
  • el-GR Modern Grieks
  • en-AU Australische Engels
  • en-CA Canadese Engels
  • en-GB Brits Engels
  • en-IE Iers Engels
  • en-IN Indiaas Engels
  • en-NZ Nieuw-Zeelandse Engels
  • en-US Amerikaans Engels
  • en-ZA Engels (Zuid-Afrika)
  • es-AR Argentijns Spaans
  • es-CL Chileens Spaans
  • es-CO Colombiaans Spaans
  • es-ES Castiliaans Spaans (gebruikt in het noordwesten van Spanje)
  • es-MX Mexicaanse Spaans
  • es-US Amerikaanse Spaans
  • fi-FI Fins (Finland)
  • fr-BE Belgische Frans
  • fr-CA Canadese Frans
  • fr-CH “Zwitserse” Frans
  • fr-FR Standaard Frans (vooral in Frankrijk)
  • he-IL Hebraïsch (Israël)
  • hi-IN Hindi (India)
  • hu-HU Magyar (Magyarország)
  • id-ID Indonesisch (Indonesië)
  • it-CH “Zwitserse” Italiaans
  • it-IT Standaard Italiaans (gebruikt in Italië)
  • ja-JP Japanes (Japan)
  • ko-KR Koreaans (Groot-Korea)
  • nl-BE Belgisch Nederlands
  • nl-NL Standaard Nederlands (Nederlands)
  • no-NO Noors (Noorwegen)
  • pl-PL Pools (Polen)
  • pt-BR Braziliaans Portugees
  • pt-PT Europees Portugees (schriftelijke en mondelinge Portugees)
  • ro-RO Roemeens (Roemenië)
  • ru-RU Russisch (Rusland)
  • sk-SK Sloveens (Slovenië)
  • sv-SE Zweeds (Zweden)
  • ta-IN Indiaas Tamils
  • ta-LK Sri Lankaans Tamils
  • th-TH Thai (Thailand)
  • tr-TR Turks (Turkije)
  • zh-CN China, vereenvoudigde karakters
  • zh-HK Hong Kong, traditionele karakters
  • zh-TW Taiwan, traditionele karakters

opties opties die het parameter accepteert:

opties waarde
currency legitieme waarden: elke munteenheidcode (zoals "EUR", "USD", "INR" enz.)
currencyDisplay

legitieme waarden:

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

legitieme waarden:

  • "best-fit"(standaard)
  • "lookup"
maximumFractionDigits een getal van 0 tot 20 (standaard is 3)
maximumSignificantDigits een getal van 1 tot 21 (standaard is 21)
minimumFractionDigits een getal van 0 tot 20 (standaard is 3)
minimumIntegerDigits een getal van 1 tot 21 (standaard is 1)
minimumSignificantDigits een getal van 1 tot 21 (standaard is 21)
style

legitieme waarden:

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

legitieme waarden:

  • "true"(standaard)
  • "false"

terugkeerwaarde

type beschrijving
string een string die de lokale geformatteerde getallen vertegenwoordigt.

technische details

terugkeerwaarde

de stringrepresentatie van het getal, bepaald door de implementatie, geformatteerd volgens de lokale normen, kan de punctuatie van de decimaal- of duizendtalloonscheidingstekens beïnvloeden.

gooid

uitzondering beschrijving
TypeError de uitzondering die wordt gegooid wanneer het object dat de methode aanroept geen Number is.

browserondersteuning

toLocaleString() is een kenmerk van ECMAScript3 (ES3).

All browsers fully support ES3 (JavaScript 1999):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Support Support Support Support Support Support