JavaScript Number.toLocaleString()Método

Number 对象参考手册Objeto Number de JavaScript

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 Austria
de-CH Alemán "suizo"
de-DE Alemán estándar
el-GR Griego moderno
en-AU Inglés de Australia
en-CA Inglés de Canadá
en-GB Inglés británico
en-IE Inglés de Irlanda
en-IN Inglés de India
en-NZ Inglés de Nueva Zelanda
en-US Inglés estadounidense
en-ZA Inglés (Sudáfrica)
es-AR Español de Argentina
es-CL Español de Chile
es-CO Español de Colombia
es-ES Español castellano (usado en el centro-norte de España)
es-MX Español de México
es-US Español (Estados Unidos)
fi-FI Finlandés (Finlandia)
fr-BE Francés de Bélgica
fr-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élgica
nl-NL Neerlandés estándar
no-NO Noruego (Noruega)
pl-PL Polaco (Polonia)
pt-BR Portugués de Brasil
pt-PT Portugués europeo
ro-RO Rumano (Rumania)
ru-RU Ruso (Federación de Rusia)
sk-SK Eslovaco (Eslovaquia)
sv-SE Sueco (Suecia)
ta-IN Tamil de India
ta-LK Tamil de Sri Lanka
th-TH Tailandés (Tailandia)
tr-TR Turco (Turquía)
zh-CN China continental, chino simplificado
zh-HK Región de Hong Kong, chino tradicional
zh-TW Región de Taiwán, chino tradicional

options Opcional. Puede ser:
  • "decimal"Para formato de número simple;
  • "currency"Para formato de moneda;
  • "percent"Para formato de porcentaje;
  • "unit"Para formato de unidades

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 »

Number 对象参考手册Objeto Number de JavaScript

Otras extensiones