Object.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 cadeia de caracteres (string) representando o objeto. Este método é feito para ser sobrescrito por objetos derivados para propósitos de localização específica.
Experimente
Sintaxe
obj.toLocaleString()
Valor de retorno
Uma string representando o objeto.
Descrição
toLocaleString
do Object
retorna o resultado da chamada toString()
.
Esta função é provida para dar aos objetos um método toLocaleString
genérico, mesmo que nem todos os usem. Veja a lista abaixo.
Objetos sobrescrevendo toLocaleString
Exemplos
Sobrescrita do Array toLocaleString()
Em objetos Array
, toLocaleString()
pode ser usado para imprimir valores do arranjo como uma string, opcionalmente com identificadores de localização específicos (como símbolos monetários) atrelados a eles:
Por exemplo:
const testArray = [4, 7, 10];
let euroPrices = testArray.toLocaleString("fr", {
style: "currency",
currency: "EUR",
});
// "4,00 €,7,00 €,10,00 €"
Sobrescrita do Date toLocaleString()
Em objetos Date
, toLocaleString()
é usado para imprimir datas mais apropriadas para localizações específicas:
Por exemplo:
const testDate = new Date(Date.now());
// "Date Fri May 29 2020 18:04:24 GMT+0100 (British Summer Time)"
let deDate = testDate.toLocaleString("de");
// "29.5.2020, 18:04:24"
var frDate = testDate.toLocaleString("fr");
//"29/05/2020 à 18:04:24"
Sobrescrita de Number toLocaleString()
Em objetos Number
, toLocaleString()
é usado para imprimir números para localizações específicas, e.g. com os corretos separadores:
Por exemplo:
const testNumber = 2901234564;
// "2901234564"
let deNumber = testNumber.toLocaleString("de");
// "2.901.234.564"
let frNumber = testNumber.toLocaleString("fr");
// "2 901 234 564"
Especificações
Specification |
---|
ECMAScript Language Specification # sec-object.prototype.tolocalestring |
Compatibilidade com navegadores
BCD tables only load in the browser