TypedArray.prototype.toLocaleString()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.
The toLocaleString()
method of TypedArray
instances returns a string representing the elements of the typed array. The elements are converted to strings using their toLocaleString
methods and these strings are separated by a locale-specific string (such as a comma ","). This method has the same algorithm as Array.prototype.toLocaleString()
.
Try it
const uint8 = new Uint32Array([500, 8123, 12]);
console.log(uint8.toLocaleString());
// Expected output: "500,8123,12"
console.log(uint8.toLocaleString("en-GB"));
// Expected output: "500,8,123,12"
console.log(
uint8.toLocaleString("de-DE", { style: "currency", currency: "EUR" }),
);
// Expected output: "500,00 €,8.123,00 €,12,00 €"
Syntax
toLocaleString()
toLocaleString(locales)
toLocaleString(locales, options)
Parameters
locales
Optional-
A string with a BCP 47 language tag, or an array of such strings. For the general form and interpretation of the
locales
argument, see the parameter description on theIntl
main page. options
Optional-
An object with configuration properties. See
Number.prototype.toLocaleString()
.
Return value
A string representing the elements of the typed array.
Description
See Array.prototype.toLocaleString()
for more details. This method is not generic and can only be called on typed array instances.
Examples
Using toLocaleString()
const 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® 2025 Language Specification # sec-%typedarray%.prototype.tolocalestring |
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
toLocaleString |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support