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
BCD tables only load in the browser