Object.prototype.toLocaleString()

This translation is incomplete. Please help translate this article from English

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.

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

Especificación
ECMAScript (ECMA-262)
La definición de 'Object.prototype.toLocaleString' en esta especificación.

Compatibilidad con navegadores

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome para AndroidFirefox para AndroidOpera para AndroidSafari en iOSSamsung InternetNode.js
toLocaleStringChrome Soporte completo 1Edge Soporte completo 12Firefox Soporte completo 1IE Soporte completo 5.5Opera Soporte completo 4Safari Soporte completo 1WebView Android Soporte completo 1Chrome Android Soporte completo 18Firefox Android Soporte completo 4Opera Android Soporte completo 10.1Safari iOS Soporte completo 1Samsung Internet Android Soporte completo 1.0nodejs Soporte completo Si

Leyenda

Soporte completo  
Soporte completo

Ver también