Easy Tutorial
❮ Prop Style Outline Prop Month Name ❯

JavaScript Number.toLocaleString() Method

JavaScript Number Object

Example

Formatting a string using local settings:


Definition and Usage

The toLocaleString() method returns a string with a language-sensitive representation of the number.

The new locales and options parameters allow applications to specify the language for formatting conversion, and to customize the behavior of the function. In older implementations, the locales and options parameters are ignored, and the language and format of the returned string depend entirely on the implementation.


Browser Support

Number.toLocaleString() is an ECMAScript3 (ES3) feature.

All browsers support ES3 (JavaScript 1999).

Chrome IE Edge Firefox Safari Opera
Yes Yes Yes Yes Yes Yes

All modern browsers support the (locales, options) parameters:

Chrome IE Edge Firefox Safari Opera
Yes 11 Yes Yes Yes Yes

Syntax

number.toLocaleString(locales, options)

Parameter Values

Parameter Description
locales Optional, a formatting object, which can be: <br> <br> ar-SA Arabic (Saudi Arabia) <br> bn-BD Bengali (Bangladesh) <br> bn-IN Bengali (India) <br> cs-CZ Czech (Czech Republic) <br> da-DK Danish (Denmark) <br> de-AT Austrian German <br> de-CH "Swiss" German <br> de-DE Standard German <br> el-GR Modern Greek <br> en-AU Australian English <br> en-CA Canadian English <br> en-GB British English <br> en-IE Irish English <br> en-IN Indian English <br> en-NZ New Zealand English <br> en-US American English <br> en-ZA English (South Africa) <br> es-AR Argentine Spanish <br> es-CL Chilean Spanish <br> es-CO Colombian Spanish <br> es-ES Castilian Spanish (used in central-northern Spain) <br> es-MX Mexican Spanish <br> es-US Spanish (United States) <br> fi-FI Finnish (Finland) <br> fr-BE Belgian French <br> fr-CA Canadian French <br> fr-CH "Swiss" French <br> fr-FR Standard French (in France) <br> he-IL Hebrew (Israel) <br> hi-IN Hindi (India) <br> hu-HU Hungarian (Hungary) <br> id-ID Indonesian (Indonesia) <br> it-CH "Swiss" Italian <br> it-IT Standard Italian (used in Italy) <br> ja-JP Japanese (Japan) <br> ko-KR Korean (South Korea) <br> nl-BE Belgian Dutch <br> nl-NL Standard Dutch <br> no-NO Norwegian (Norway) <br> pl-PL Polish (Poland) <br> pt-BR Brazilian Portuguese <br> pt-PT European Portuguese <br> ro-RO Romanian (Romania) <br> ru-RU Russian (Russian Federation) <br> sk-SK Slovak (Slovakia) <br> sv-SE Swedish (Sweden) <br> ta-IN Tamil (India) <br> ta-LK Sri Lankan Tamil <br> th-TH Thai (Thailand) <br> tr-TR Turkish (Turkey) <br> zh-CN Mainland China, Simplified Chinese <br> zh-HK Hong Kong, Traditional Chinese <br> zh-TW Taiwan, Traditional Chinese <br> <br>
options Optional, can be: "decimal" for plain number formatting; <br> "currency" for currency formatting; <br> "percent" for percentage formatting; <br> "unit" for unit formatting

Return Value

Type Description
String Returns a string representation of the number in the specified locale.

Technical Details

| JavaScript Version: | ECMAScript 6 | | --- | --- |


More Examples

Example

Formatting a currency string using optional parameters:

JavaScript Number Object

❮ Prop Style Outline Prop Month Name ❯