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