Método Number toLocaleString() de JavaScript

Definición y uso

toLocaleString() Devuelve el número como una cadena utilizando el formato de lenguaje local.

El formato de lenguaje depende de la configuración regional de su computadora.

Ejemplo

Ejemplo 1

Utilice la configuración regional para formatear el número como una cadena:

let num = 1000000;
let text = num.toLocaleString();

Prueba personalmente

Ejemplo 2

Utilice el entorno de lenguaje específico de Finlandia para formatear el número como una cadena:

let num = 1000000;
let text = num.toLocaleString("fi-FI");

Prueba personalmente

Ejemplo 3

Utilice el entorno de lenguaje específico de Estados Unidos para formatear el número como una cadena de moneda:

let num = 1000000;
let text = num.toLocaleString("en-US", {style:"currency", currency:"USD"});

Prueba personalmente

Ejemplo 4

Uso options Formato de moneda con parámetros (objeto):

let num = new Number(1000000);
const myObj = {
  style: "currency",
  currency: "EUR"
}
let text = num.toLocaleString("en-GB", myObj);

Prueba personalmente

Ejemplo 5

let num = new Number(1000000);
let text = num.toLocaleString("en-GB", {style:"currency", currency:"EUR"});

Prueba personalmente

Ejemplo 6

Uso del entorno de lenguaje específico de JAPAN:

let num = 1000000;
let text = num.toLocaleString("ja-JP", {style:"currency", currency:"JPY"});

Prueba personalmente

Gramática

number.toLocaleString(locales, options)

Parámetro

Parámetro Descripción
locales Opcional. Formato específico del idioma utilizado. Vea la tabla siguiente.
options Opcional. Objeto con opciones de formato. Vea la tabla siguiente.

locales Valores admitidos:

  • ar-SA Árabe (Arabia Saudita)
  • bn-BD Bengalí (Bangladesh)
  • bn-IN Bengalí (India)
  • cs-CZ Checo (República Checa)
  • da-DK Danés (Dinamarca)
  • de-AT Alemán austríaco
  • de-CH Alemán suizo
  • de-DE Alemán estándar (usado en Alemania)
  • el-GR Griego moderno
  • en-AU Inglés australiano
  • en-CA Inglés canadiense
  • en-GB Inglés británico
  • en-IE Inglés irlandés
  • en-IN Inglés indio
  • en-NZ Inglés de Nueva Zelanda
  • en-US Inglés de Estados Unidos
  • en-ZA Inglés (Sudáfrica)
  • es-AR Español argentino
  • es-CL Español chileno
  • es-CO Español colombiano
  • es-ES Español castellano (usado en el centro y norte de España)
  • es-MX Español mexicano
  • es-US Español de Estados Unidos
  • fi-FI Finlandés (Finlandia)
  • fr-BE Francés belga
  • fr-CA Francés canadiense
  • fr-CH Francés suizo
  • fr-FR Francés estándar (especialmente en Francia)
  • he-IL Hebreo (Israel)
  • hi-IN Hindi (India)
  • hu-HU Húngaro (Hungría)
  • id-ID Indonesio (Indonesia)
  • it-CH “Suizo” italiano
  • it-IT Italiano estándar (usado en Italia)
  • ja-JP Japonés (Japón)
  • ko-KR Coreano (República de Corea)
  • nl-BE Holandés de Bélgica
  • nl-NL Holandés estándar (Holandés)
  • no-NO Noruego (Noruega)
  • pl-PL Polaco (Polonia)
  • pt-BR Portugués de Brasil
  • pt-PT Portugués europeo (portugués escrito y hablado)
  • ro-RO Rumano (Rumania)
  • ru-RU Ruso (Federación Rusa)
  • sk-SK Eslovaco (Eslovaquia)
  • sv-SE Sueco (Suecia)
  • ta-IN Tamil de la India
  • ta-LK Tamil de Sri Lanka
  • th-TH Tailandés (Tailandia)
  • tr-TR Turco (Turquía)
  • zh-CN China continental, caracteres simplificados
  • zh-HK Hong Kong, caracteres tradicionales
  • zh-TW Taiwán, caracteres tradicionales

options Opciones aceptadas por el parámetro:

Opciones Valor
currency Valores válidos: cualquier código de moneda (como "EUR", "USD", "INR", etc.).
currencyDisplay

Valores válidos:

  • "symbol"(por defecto)
  • "code"
  • "name"
localeMatcher

Valores válidos:

  • "best-fit"(por defecto)
  • "lookup"
maximumFractionDigits Número de 0 a 20 (por defecto 3)
maximumSignificantDigits Número de 1 a 21 (por defecto 21)
minimumFractionDigits Número de 0 a 20 (por defecto 3)
minimumIntegerDigits Número de 1 a 21 (por defecto 1)
minimumSignificantDigits Número de 1 a 21 (por defecto 21)
style

Valores válidos:

  • "currency"
  • "decimal"(por defecto)
  • "percent"
useGrouping

Valores válidos:

  • "true"(por defecto)
  • "false"

Valor devuelto

Tipo Descripción
Cadena Cadena que representa el número en formato local.

Detalles técnicos

Valor devuelto

La representación de cadena de número, decidida por la implementación, se formatea según la norma local, lo que puede afectar los símbolos de puntuación utilizados para el punto decimal o el separador de miles.

Lanza

Excepción Descripción
TypeError Lanza una excepción cuando el objeto llamado no es Number.

Compatibilidad del navegador

toLocaleString() Es una característica de ECMAScript3 (ES3).

Todos los navegadores admiten completamente ES3 (JavaScript 1999):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Soporte Soporte Soporte Soporte Soporte Soporte