TypedArray.prototype.toLocaleString()

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.

See the 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

See also