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 Language Specification
# sec-array.prototype.tolocalestring
ECMAScript Internationalization API Specification
# sup-array.prototype.tolocalestring

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também