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.
El método toLocaleString()
devuelve un string que representa a un objeto. Este método está pensado para ser redefinido en los objetos derivados, para los propósitos específicos de cada configuración regional.
Pruébalo
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"
Sintaxis
objeto.toLocaleString()
Valor de retorno
Un string que representa al objeto.
Descripción
Object
's toLocaleString
devuelve el resultado de llamar a toString()
.
Se proporciona esta función para que los objetos dispongan de un método toLocaleString
genérico, aunque puede que no todos la utilicen. Véase la lista siguiente.
Objetos que redefinen toLocaleString
Ejemplos
Redefinición de toLocaleString() en Array
En los objetos Array
se puede utilizar toLocaleString()
para imprimir los valores del array como un string, con indicadores opcionales de configuración regional (como símbolos de moneda) aplicados.
Por ejemplo:
const unArray = [4, 7, 10];
let preciosEnEuros = unArray.toLocaleString("fr", {
style: "currency",
currency: "EUR",
});
// "4,00 €,7,00 €,10,00 €"
Redefinición de toLocaleString() para Date
En los objetos Date
se usa toLocaleString()
para imprimir fechas en un formato adecuado a la configuración regional.
Por ejemplo:
const unaFecha = new Date(Date.now());
// "2020-07-07T19:51:44.046Z"
let fechaAleman = unaFecha.toLocaleString("de");
// "7.7.2020, 21:55:22"
var fechaFrances = unaFecha.toLocaleString("fr");
//"07/07/2020 à 21:55:22"
Redefinición de toLocaleString() para Number
En los objetos Number
se usa toLocaleString()
para imprimir números de forma adecuada a la configuración regional, p. ej. para usar los separadores de miles correctos.
Por ejemplo:
const unNumero = 2901234564;
// "2901234564"
let numeroAleman = unNumero.toLocaleString("de");
// "2.901.234.564"
let numeroFrances = unNumero.toLocaleString("fr");
// "2 901 234 564"
Especificaciones
Specification |
---|
ECMAScript® 2025 Language Specification # sec-object.prototype.tolocalestring |
Compatibilidad con navegadores
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
toLocaleString |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support