JavaScript Number toLocaleString() Method
Example
Format the number to a string, using the locale specific of FINLAND:
var num = new Number(1000000).toString("fi-FI");
Try it Yourself »
Definition and Usage
The toLocaleString() method converts a number into a string, using a local language format.
The default language depends on the locale setup on your computer.
Browser Support
The parameters locales and options were not supported until ECMAScript 5, and these browser versions:
toLocaleString() | Yes | Yes | Yes | Yes | Yes |
locales | 24 | 11 | 29 | 10 | 15 |
options | 24 | 11 | 29 | 10 | 15 |
Syntax
number.toLocaleString(locales, options)
Parameter Values
Parameter | Description | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
locales Try it |
Optional. Which language specific format to use. Click on the "Try it" button to see all values in action. Legal Values: ar-SA Arabic (Saudi Arabia)bn-BD Bangla (Bangladesh)bn-IN Bangla (India)cs-CZ Czech (Czech Republic)da-DK Danish (Denmark)de-AT Austrian Germande-CH "Swiss" Germande-DE Standard German (as spoken in Germany)el-GR Modern Greeken-AU Australian Englishen-CA Canadian Englishen-GB British Englishen-IE Irish Englishen-IN Indian Englishen-NZ New Zealand Englishen-US US Englishen-ZA English (South Africa)es-AR Argentine Spanishes-CL Chilean Spanishes-CO Colombian Spanishes-ES Castilian Spanish (as spoken in Central-Northern Spain)es-MX Mexican Spanishes-US American Spanishfi-FI Finnish (Finland)fr-BE Belgian Frenchfr-CA Canadian Frenchfr-CH "Swiss" Frenchfr-FR Standard French (especially in France)he-IL Hebrew (Israel)hi-IN Hindi (India)hu-HU Hungarian (Hungary)id-ID Indonesian (Indonesia)it-CH "Swiss" Italianit-IT Standard Italian (as spoken in Italy)jp-JP Japanese (Japan)ko-KR Korean (Republic of Korea)nl-BE Belgian Dutchnl-NL Standard Dutch (as spoken in The Netherlands)no-NO Norwegian (Norway)pl-PL Polish (Poland)pt-BR Brazilian Portuguesept-PT European Portuguese (as written and spoken in Portugal)ro-RO Romanian (Romania)ru-RU Russian (Russian Federation)sk-SK Slovak (Slovakia)sv-SE Swedish (Sweden)ta-IN Indian Tamilta-LK Sri Lankan Tamilth-TH Thai (Thailand)tr-TR Turkish (Turkey)zh-CN Mainland China, simplified characterszh-HK Hong Kong, traditional characterszh-TW Taiwan, traditional characters |
||||||||||||||||||||
options | Optional. An object were you can set some properties. Legal properties:
|
Technical Details
Return Value: | A String, representing a number |
---|---|
JavaScript Version: | ECMAScript 3 |
More Examples
Example
Use the options parameter to format the number into a currency string:
var n = new Number(1000000);
var myObj = {
style: "currency",
currency: "EUR"
}
x = n.toLocaleString("en-GB", myObj);
Try it Yourself »
❮ JavaScript Number Reference