Object.prototype.toLocaleString()

BaselineWidely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

El métodotoLocaleString() 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'stoLocaleString devuelve el resultado de llamar atoString().

Se proporciona esta función para que los objetos dispongan de un métodotoLocaleString 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 objetosArray se puede utilizartoLocaleString() para imprimir los valores delarray 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 objetosDate se usatoLocaleString() 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 objetosNumber se usatoLocaleString() 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"