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