Array.prototype.toLocaleString()
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áginaIntl
. options
Optional- 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
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 com navegadores
Estamos convertendo nossos dados de compatibilidade para o formato JSON.
Esta tabela de compatibilidade ainda usa o formato antigo,
pois ainda não convertemos os dados que ela contém.
Descubra como você pode ajudar! (en-US)
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) |