JavaScript Number toLocaleString() metode

Definition og brug

toLocaleString() Returnerer tallet som en streng ved hjælp af det lokale sprogformat.

Sprogformatet afhænger af regionssætningen på din computer.

Eksempel

Eksempel 1

Brug af regionssætningen til at formate tallet som en streng:

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

Prøv det selv

Eksempel 2

Brug af det specifikke sprogmiljø i Finland til at formate tallet som en streng:

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

Prøv det selv

Eksempel 3

Brug af det specifikke sprogmiljø i USA til at formate tallet som en pengestreng:

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

Prøv det selv

Eksempel 4

Brug options Parameter (objekt) til valutaformatering:

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

Prøv det selv

Eksempel 5

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

Prøv det selv

Eksempel 6

Brug JAPANS specifikke sprogmiljø:

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

Prøv det selv

Grammatik

number.toLocaleString(locales, options)

Parameter

Parameter Beskrivelse
locales Valgfri. At bruge sprogspecifikke formater. Se tabellen nedenfor.
options Valgfri. Et objekt med formateringsvalg. Se tabellen nedenfor.

locales Parameter, der kan accepteres:

  • ar-SA Arabisk (Saudi-Arabien)
  • bn-BD Bengali (Bangladesh)
  • bn-IN Bengali (India)
  • cs-CZ Tjekkisk (Tjekkiske republik)
  • da-DK Dansk (Danmark)
  • de-AT Østrigsk tysk
  • de-CH Schweizerdeutsch
  • de-DE Standardtysk (bruges i Tyskland)
  • el-GR Modern græsk
  • en-AU Australisk engelsk
  • en-CA Canadansk engelsk
  • en-GB Britisk engelsk
  • en-IE Irsk engelsk
  • en-IN Indisk engelsk
  • en-NZ Newzealandsk engelsk
  • en-US Amerikansk engelsk
  • en-ZA Engelsk (Sydafrika)
  • es-AR Argentinsk spansk
  • es-CL Chilensk spansk
  • es-CO Colombiansk spansk
  • es-ES Kastiljansk spansk (bruges i Spaniens nordlige og centrale dele)
  • es-MX Mexicansk spansk
  • es-US Amerikansk spansk
  • fi-FI Finsk (Finland)
  • fr-BE Belgisk fransk
  • fr-CA Kanadansk fransk
  • fr-CH Schweizerdeutsch
  • fr-FR Standard French (særligt i Frankrig)
  • he-IL Hebrew (Israel)
  • hi-IN Hindi (India)
  • hu-HU Magyar nyelv (Magyarország)
  • id-ID Indonesisk (Indonesien)
  • it-CH “Schweiz” italiensk
  • it-IT Standard italiensk (brugt i Italien)
  • ja-JP Japansk (Japan)
  • ko-KR Koreansk (Republikken Korea)
  • nl-BE Belgisk nederlandsk
  • nl-NL Standard nederlandsk (hollandsk)
  • no-NO Norsk (Norge)
  • pl-PL Polsk (Polen)
  • pt-BR Brasiliansk portugisisk
  • pt-PT Europæisk portugisisk (skriftlig og muntlig portugisisk)
  • ro-RO Rumænsk (Rumænien)
  • ru-RU Russisk (Rusland)
  • sk-SK Slovakisk (Slovakiet)
  • sv-SE Svensk (Sverige)
  • ta-IN Indisk tamil
  • ta-LK Srilankesisk tamil
  • th-TH Thai (Thailand)
  • tr-TR Tyrkisk (Tyrkiet)
  • zh-CN Kina, simpel kinesisk
  • zh-HK Hong Kong, traditionel kinesisk
  • zh-TW Taiwan, traditionel kinesisk

options Valgmuligheder, der accepteres af parameteren:

Valgmuligheder Værdi
currency Gyldige værdier: Enhver valuta kode (som "EUR", "USD", "INR" osv.)
currencyDisplay

Gyldige værdier:

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

Gyldige værdier:

  • "best-fit"(Standard)
  • "lookup"
maximumFractionDigits Et tal fra 0 til 20 (standard er 3)
maximumSignificantDigits Et tal fra 1 til 21 (standard er 21)
minimumFractionDigits Et tal fra 0 til 20 (standard er 3)
minimumIntegerDigits Et tal fra 1 til 21 (standard er 1)
minimumSignificantDigits Et tal fra 1 til 21 (standard er 21)
style

Gyldige værdier:

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

Gyldige værdier:

  • "true"(Standard)
  • "false"

Returværdi

Type Beskrivelse
Streng En streng, der repræsenterer det lokale format af et tal.

Tekniske detaljer

Returværdi

En strengrepræsentation af tallet, som bestemmes af implementeringen, formateret efter den lokale standard, hvilket kan påvirke den punktum eller tusindseparatortegn, der bruges ved decimaler eller tusindtall.

Kaster

Undtagelse Beskrivelse
TypeError En unødvendig undtagelse kastes, hvis objektet, der kaldes denne metode, ikke er et Number.

Browserstøtte

toLocaleString() Er en ECMAScript3 (ES3) funktion.

Alle browsere understøtter fuldt ES3 (JavaScript 1999):

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