JavaScript Number toLocaleString() metod

Definition och användning

toLocaleString() Returnera ett nummer som en sträng med lokala språkformat.

Språkformatet beror på regioninställningarna på din dator.

Exempel

Exempel 1

Använd regioninställningen för att formatera ett nummer till en sträng:

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

Prova själv

Exempel 2

Använd Finlands specifika språkinställning för att formatera ett nummer till en sträng:

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

Prova själv

Exempel 3

Använd USA:s specifika språkinställning för att formatera ett nummer till en valutastring:

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

Prova själv

Exempel 4

Använd options Parameter (objekt) för valutaformatering:

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

Prova själv

Exempel 5

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

Prova själv

Exempel 6

Använd JAPANS specifika språkinställning:

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

Prova själv

grammatik

number.toLocaleString(locales, options)

Parameter

Parameter Beskrivning
locales Valfritt. Språkspecifika format som används. Se tabellen nedan.
options Valfritt. Ett objekt med formatval. Se tabellen nedan.

locales Parameter som är acceptabla värden:

  • ar-SA Arabiska (Saudi-Arabien)
  • bn-BD Bengali (Bangladesh)
  • bn-IN Bengali (Indien)
  • cs-CZ Tjeckiska (Tjeckiska republiken)
  • da-DK Danska (Danmark)
  • de-AT Österrikiskt tyska
  • de-CH Schweiztyska
  • de-DE Standardtyska (används i Tyskland)
  • el-GR Moderna grekiska
  • en-AU Australiskt engelska
  • en-CA Kanadenskt engelska
  • en-GB Brittiskt engelska
  • en-IE Irländskt engelska
  • en-IN Indiskt engelska
  • en-NZ Nya Zeelands engelska
  • en-US Amerikanskt engelska
  • en-ZA Engelska (Sudafrika)
  • es-AR Argentinsk spanska
  • es-CL Chilenskt spanska
  • es-CO Kolumbianskt spanska
  • es-ES Kastilianskt spanska (används i norra och centrala Spanien)
  • es-MX Mexikanskt spanska
  • es-US Amerikanskt spanska
  • fi-FI Finska (Finland)
  • fr-BE Belgisk franska
  • fr-CA Kanadafanska
  • fr-CH Schweizfranska
  • fr-FR Standardfranska (särskilt i Frankrike)
  • he-IL Hebreiska (Israel)
  • hi-IN Hindi (Indien)
  • hu-HU Ungerska (Ungern)
  • id-ID Indonesiska (Indonesien)
  • it-CH ‘Schweiz’ italienska
  • it-IT Standard italienska (i Italien används)
  • ja-JP Japanska (Japan)
  • ko-KR Koreanska (Sydkorea)
  • nl-BE Belgiska nederländska
  • nl-NL Standard nederländska (nederländska)
  • no-NO Norska (Norge)
  • pl-PL Polska (Polen)
  • pt-BR Brasilien portugisiska
  • pt-PT Europeisk portugisiska (skriftlig och muntlig portugisiska)
  • ro-RO Rumänska (Rumänien)
  • ru-RU Ryska (Rysslands federation)
  • sk-SK Slovakiska (Slovakien)
  • sv-SE Svenska (Sverige)
  • ta-IN Indisk tamil
  • ta-LK Srilankesisk tamil
  • th-TH Thai (Thailand)
  • tr-TR Turkiska (Turkiet)
  • zh-CN Kina, förenklad kinesiska
  • zh-HK Hong Kong, traditionell kinesiska
  • zh-TW Taiwan, traditionell kinesiska

options Alternativ som tas emot av parametern:

Alternativ Värde
currency Giltiga värden: Vilken som helst valuta kod (t.ex. "EUR", "USD", "INR" m.m.)
currencyDisplay

Giltiga värden:

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

Giltiga värden:

  • "best-fit"(Standard)
  • "lookup"
maximumFractionDigits Numer från 0 till 20 (standard är 3)
maximumSignificantDigits Numer från 1 till 21 (standard är 21)
minimumFractionDigits Numer från 0 till 20 (standard är 3)
minimumIntegerDigits Numer från 1 till 21 (standard är 1)
minimumSignificantDigits Numer från 1 till 21 (standard är 21)
style

Giltiga värden:

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

Giltiga värden:

  • "true"(Standard)
  • "false"

Returvärdet

Typ Beskrivning
Sträng Sträng som representerar lokalt formaterat tal.

Tekniska detaljer

Returvärdet

Strängrepresentation av talet, som bestäms av implementeringen, formateras enligt lokala normer och kan påverka användningen av punkt- eller tusenseparator.

Utlöst

Undantag Beskrivning
TypeError En undantag utlöses om objektet som anropar denna metod inte är Number.

Webbläsarens stöd

toLocaleString() Är en egenskap i ECMAScript3 (ES3).

Alla webbläsare stöder fullt ut ES3 (JavaScript 1999):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Stöd Stöd Stöd Stöd Stöd Stöd