The toLocaleString()
method returns a string representing the elements of the typed array. The elements are converted to strings and are separated by a locale-specific string (such as a comma “,”). This method has the same algorithm as Array.prototype.toLocaleString()
and, as the typed array elements are numbers, the same algorithm as Number.prototype.toLocaleString()
applies for each element. TypedArray is one of the typed array types here.
Syntax
typedarray.toLocaleString([locales [, options]]);
Parameters
The locales
and options
arguments customize the behavior of the function and let applications specify the language whose formatting conventions should be used. In implementations, which ignore the locales
and options
arguments, the locale used and the form of the string returned are entirely implementation dependent.
Intl.NumberFormat()
constructor for details on these parameters and how to use them.Return value
A string representing the elements of the typed array.
Examples
Using toLocaleString
var uint = new Uint32Array([2000, 500, 8123, 12, 4212]); uint.toLocaleString(); // if run in a de-DE locale // "2.000,500,8.123,12,4.212" uint.toLocaleString('en-US'); // "2,000,500,8,123,12,4,212" uint.toLocaleString('ja-JP', { style: 'currency', currency: 'JPY' }); // "¥2,000,¥500,¥8,123,¥12,¥4,212"
Specifications
Specification |
---|
ECMAScript (ECMA-262) The definition of 'TypedArray.prototype.toLocaleString' in that specification. |
Browser compatibility
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
toLocaleString | Chrome Full support 7 | Edge Full support 12 | Firefox Full support 51 | IE Full support 10 | Opera Full support 11.6 | Safari Full support 5.1 | WebView Android Full support ≤37 | Chrome Android Full support 18 | Firefox Android Full support 51 | Opera Android Full support 12 | Safari iOS Full support 5 | Samsung Internet Android Full support 1.0 | nodejs Full support 0.10 |
Legend
- Full support
- Full support