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.
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.
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"
obj.toLocaleString()
Uma string representando o objeto.
toLocaleString do 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.
Em objetos 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 €"
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"
Em objetos 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"
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-object.prototype.tolocalestring |