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 julho de 2015.
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
const date1 = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));
console.log(date1.toLocaleString("ar-EG"));
// Expected output: "٢٠/١٢/٢٠١٢ ٤:٠٠:٠٠ ص"
const number1 = 123456.789;
console.log(number1.toLocaleString("de-DE"));
// Expected output: "123.456,789"
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® 2026 Language Specification # sec-object.prototype.tolocalestring |