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

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() (en-US).

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 (en-US).

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