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 July 2015.
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
localesOptional-
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áginaIntl. optionsOptional-
Um objeto com as propriedades de configurações, para números veja
Number.prototype.toLocaleString(), e para datas vejaDate.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:
Object:Object.prototype.toLocaleString()Number:Number.prototype.toLocaleString()Date:Date.prototype.toLocaleString()
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® 2026 Language Specification # sec-array.prototype.tolocalestring |
| ECMAScript® 2026 Internationalization API Specification # sup-array.prototype.tolocalestring |