Array.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.

O método toLocaleString() retorna uma representaçao de elementos de um array. Os elementos são convertidos para Strings utilizando seus respectivos métodos toLocaleString e essas cadeias são separadas por uma sequência específica de localidade (separados por virgula ",").

Sintaxe

array.toLocaleString();

Parâmetros

locales Optional

Uma string com uma tag de linguagem BCP 47, ou um array como strings. Para uma forma geral e uma interpretação do arquivo locales, veja a página Intl.

options Optional

Um objeto com as propriedades de configurações, para números veja Number.prototype.toLocaleString(), e para datas veja Date.prototype.toLocaleString().

Retorno

Uma string que representa os elementos de um array.

Exemplos

Usando toLocaleString

Os elementos de um array são convertidos para strings usando seus respectivos métodos toLocaleString:

js
var numero = 1337;
var data = new Date();
var meuArray = [numero, data, "foo"];

var resultado = meuArray.toLocaleString();

console.log(resultado);
// saída '1337,July 26, 2015 at 20:02:23 GMT-3,foo'
// se estiver no Brasil com o fuso horario GMT-0300 (BRT) de Brasília.

Para mais exemplos, veja as páginas Intl, NumberFormat, e DateTimeFormat.

Especificações

Specification
ECMAScript® 2025 Language Specification
# sec-array.prototype.tolocalestring
ECMAScript® 2025 Internationalization API Specification
# sup-array.prototype.tolocalestring

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
toLocaleString
locales parameter
options parameter

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
Has more compatibility info.

Veja também