Array.prototype.toLocaleString()

Você está lendo a versão em inglês deste conteúdo porque ainda não há uma tradução para este idioma. Ajude-nos 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

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!
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

Tópicos relacionados
  1. Standard built-in objects
  2. Array
  3. Propriedades
    1. Array.prototype.length
    2. Array.prototype
    3. Array.prototype[@@unscopables]
  4. Métodos
    1. Array.from()
    2. Array.isArray()
    3. Array.observe()
    4. Array.of()
    5. Array.prototype.concat()
    6. Array.prototype.copyWithin()
    7. Array.prototype.entries()
    8. Array.prototype.every()
    9. Array.prototype.fill()
    10. Array.prototype.filter()
    11. Array.prototype.find()
    12. Array.prototype.findIndex()
    13. Array.prototype.flat()
    14. Array.prototype.flatMap()
    15. Array.prototype.forEach()
    16. Array.prototype.includes()
    17. Array.prototype.indexOf()
    18. Array.prototype.join()
    19. Array.prototype.keys()
    20. Array.prototype.lastIndexOf()
    21. Array.prototype.map()
    22. Array.prototype.pop()
    23. Array.prototype.push()
    24. Array.prototype.reduce()
    25. Array.prototype.reduceRight()
    26. Array.prototype.reverse()
    27. Array.prototype.shift()
    28. Array.prototype.slice()
    29. Array.prototype.some()
    30. Array.prototype.sort()
    31. Array.prototype.splice()
    32. Array.prototype.toLocaleString()
    33. Array.prototype.toSource()
    34. Array.prototype.toString()
    35. Array.prototype.unshift()
    36. Array.prototype.values()
    37. Array.prototype[@@iterator]()
    38. Array.unobserve()
    39. get Array[@@species]
  5. Herança:
  6. Function
  7. Propriedades
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.prototype
    7. Function.name
  8. Métodos
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator() [Traduzir]
    5. Function.prototype.toSource()
    6. Function.prototype.toString() [Traduzir]
  9. Object
  10. Propriedades
    1. Object.prototype.__count__
    2. Object.prototype.__noSuchMethod__ [Traduzir]
    3. Object.prototype.__parent__ [Traduzir]
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  11. Métodos
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__() [Traduzir]
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__() [Traduzir]
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable() [Traduzir]
    8. Object.prototype.toLocaleString() [Traduzir]
    9. Object.prototype.toSource() [Traduzir]
    10. Object.prototype.toString()
    11. Object.prototype.unwatch() [Traduzir]
    12. Object.prototype.valueOf()
    13. Object.prototype.watch() [Traduzir]
    14. Object.setPrototypeOf()