Esta tradução está incompleta. Por favor, ajude a traduzir este artigo.

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:

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

Especificação Status Comentários
ECMAScript 3rd Edition (ECMA-262) Padrão Definição inicial.
ECMAScript 5.1 (ECMA-262)
The definition of 'Array.prototype.toLocaleString' in that specification.
Padrão  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Array.prototype.toLocaleString' in that specification.
Padrão  

Compatibilidade do Browser

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suporte Básico (Yes) (Yes) (Yes) (Yes) (Yes)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Suporte Básico (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

Veja também

Etiquetas do documento e colaboradores

Colaboradores desta página: valdeirpsr, erickvieira, ErickWendel
Última atualização por: valdeirpsr,