JavaScript Number.toLocaleString()Método
Ejemplo
Formatear una cadena usando la configuración local:
let num1 = 1000000;
let text1 = num1.toLocaleString();
//Formatear un número como cadena usando un locale específico
let num2 = 1000000;
let text2 = num2.toLocaleString("fi-FI");
//Formatear un número como cadena de moneda usando un locale específico
//Yuan chino (CNY)
let num3 = 1000000;
let text3 = num3.toLocaleString("zh-CN", {style:"currency", currency:"CNY"});
//Dólar estadounidense (USD)
let num4 = 1000000;
let text4 = num4.toLocaleString("en-US", {style:"currency", currency:"USD"});
Pruébalo »
Definición y uso
El método toLocaleString() devuelve una cadena de representación del número en un locale específico.
Los nuevos parámetros locales y options permiten a la aplicación especificar el idioma para el formato y personalizar el comportamiento de la función. En implementaciones antiguas, los parámetros locales y options se ignoran, y el locale utilizado y la forma de la cadena devuelta dependen completamente de la implementación.
Soporte del navegador
Number.toLocaleString() es una característica de ECMAScript3 (ES3).
Todos los navegadores admiten ES3 (JavaScript 1999).
| Chrome | IE | Edge | Firefox | Safari | Opera |
| Yes | Yes | Yes | Yes | Yes | Yes |
Compatible con las últimas versiones de todos los navegadores(locales, options)Parámetros:
| Chrome | IE | Edge | Firefox | Safari | Opera |
| Yes | 11 | Yes | Yes | Yes | Yes |
Sintaxis
number.toLocaleString(locales, options)
Valores de parámetros
| Parámetro | Descripción |
|---|---|
| locales | Opcional. Objeto de formato, puede ser:ar-SA Árabe (Arabia Saudita)bn-BD Bengalí (Bangladés)bn-IN Bengalí (India)cs-CZ Checo (República Checa)da-DK Danés (Dinamarca)de-AT Alemán de Austriade-CH Alemán "suizo"de-DE Alemán estándarel-GR Griego modernoen-AU Inglés de Australiaen-CA Inglés de Canadáen-GB Inglés británicoen-IE Inglés de Irlandaen-IN Inglés de Indiaen-NZ Inglés de Nueva Zelandaen-US Inglés estadounidenseen-ZA Inglés (Sudáfrica)es-AR Español de Argentinaes-CL Español de Chilees-CO Español de Colombiaes-ES Español castellano (usado en el centro-norte de España)es-MX Español de Méxicoes-US Español (Estados Unidos)fi-FI Finlandés (Finlandia)fr-BE Francés de Bélgicafr-CA Francés de Canadáfr-CH Francés "suizo"fr-FR Francés estándar (en Francia)he-IL Hebreo (Israel)hi-IN Hindi (India)hu-HU Húngaro (Hungría)id-ID Indonesio (Indonesia)it-CH Italiano "suizo"it-IT Italiano estándar (usado en Italia)ja-JP Japonés (Japón)ko-KR Coreano (Corea del Sur)nl-BE Neerlandés de Bélgicanl-NL Neerlandés estándarno-NO Noruego (Noruega)pl-PL Polaco (Polonia)pt-BR Portugués de Brasilpt-PT Portugués europeoro-RO Rumano (Rumania)ru-RU Ruso (Federación de Rusia)sk-SK Eslovaco (Eslovaquia)sv-SE Sueco (Suecia)ta-IN Tamil de Indiata-LK Tamil de Sri Lankath-TH Tailandés (Tailandia)tr-TR Turco (Turquía)zh-CN China continental, chino simplificadozh-HK Región de Hong Kong, chino tradicionalzh-TW Región de Taiwán, chino tradicional |
| options | Opcional. Puede ser:
|
Valor de retorno
| Tipo | Descripción |
|---|---|
| Cadena | Devuelve una cadena de representación en un locale específico. |
Detalles técnicos
| Versión de JavaScript: | ECMAScript 6 |
|---|
Más ejemplos
Ejemplo
Usar parámetros opcionales para formatear cadenas de moneda:
let num1 = new Number(1000000);
const myObj = {
style: "currency",
currency: "EUR"
}
let text1 = num1.toLocaleString("en-GB", myObj);
let num2 = new Number(1000000);
let text2 = num2.toLocaleString("en-GB", {style:"currency", currency:"EUR"});
//Yuan chino (CNY)
let num3 = 1000000;
let text3 = num3.toLocaleString("zh-CN", {style:"currency", currency:"CNY"});
//Yen japonés (JPY)
let num4 = 1000000;
let text4 = num4.toLocaleString("ja-JP", {style:"currency", currency:"JPY"});
Pruébalo »
Objeto Number de JavaScript