Los datos expuestos en este blog, son solo de índole informativo. Por favor realiza siempre una copia de seguridad antes de realizar cualquier cambio en tu proyecto.
JavaScript: método Number toLocaleString()
Este tutorial de JavaScript muestra, con sintaxis y ejemplos, cómo usar el método Number llamado toLocaleString().
describir
En JavaScript, toLocaleString() es un método numérico que convierte un número en una representación numérica específica del lugar (redondeando el resultado si es necesario) y devuelve su valor como una cadena. Debido a que toLocaleString() es un método del objeto Number, debe llamarse desde una instancia específica de la clase Number.
sintaxis
En JavaScript, la sintaxis del método toLocaleString() es:
number.toLocaleString([locale [, options]]);
parámetro o parámetro
La configuración regional es opcional. Es una etiqueta de idioma BCP 47 o una matriz de dichas etiquetas lo que determina la representación numérica de un número. La etiqueta de idioma BCP 47 define un idioma que puede contener códigos y extensiones del idioma principal. Si no se proporciona este parámetro, el método toLocaleString() utilizará la configuración regional actual del entorno de alojamiento.Opciones
Electivo. Opciones para aplicar. Puede ser uno o más de los siguientes:
valor | describir |
---|---|
comparador de regiones | Determine qué algoritmo de coincidencia de configuración regional usar. Puede ser uno de los siguientes valores:
|
estilo | Determina el estilo de formato a utilizar. Puede ser uno de los siguientes valores:
|
divisa | Determine el formato de moneda a utilizar.Puede ser uno de los códigos de moneda alfa de 3 dígitos Código de moneda ISO 4217Por ejemplo, EUR significa euro, USD es dólar estadounidense e INR es rupia india (consulte la lista de códigos de moneda ISO 4217). |
pantalla de moneda | Determina cómo se muestra el formato de moneda. Puede ser uno de los siguientes valores:
|
uso de agrupación | Determina si se muestran los separadores de agrupación. Puede ser uno de los siguientes valores:
|
Número mínimo de dígitos enteros | Determina el número entero mínimo de dígitos para mostrar. Puede ser un valor entre 1 y 21. Si se omite, el valor predeterminado es 1. |
Número mínimo de fracciones | Determina el número mínimo de lugares decimales para mostrar. Puede ser un valor entre 0 y 20. Si se omite, el valor predeterminado para el decimal es 0, el valor predeterminado para el porcentaje es 0 y el valor predeterminado para la moneda es el valor de “unidad menor” que especifica el código de moneda ISO 4217. |
Número máximo de fracciones | Determina el número máximo de lugares decimales para mostrar. Puede ser un valor entre 0 y 20. Si se omite, el valor predeterminado de decimal es el mayor de 3 y mínimoFractionDigits, el valor predeterminado de porcentaje es el mayor de 0 y mínimoFractionDigits, y el valor predeterminado de moneda es “especifique el código de moneda ISO 4217 y la unidad menor de mínimoFractionDigits ” valor . |
dígito menos significativo | Determina el número menos significativo de dígitos a mostrar. Puede ser un valor entre 1 y 21. Si se omite, el valor predeterminado es 1. |
número máximo de dígitos significativos | Determina el número máximo de dígitos significativos a mostrar. Puede ser un valor entre 1 y 21. Si se omite, el valor predeterminado es 21. |
devolver los bienes
El método toLocaleString() convierte el número en una representación local específica del número (redondeando el resultado si es necesario) y luego devuelve su valor como una cadena.
notas
- El método toLocaleString() redondeará el valor resultante si es necesario.
- El método toLocaleString() no cambia el valor del número original.
ejemplo
Veamos un ejemplo de cómo usar el método toLocaleString() en JavaScript.
Por ejemplo:
var totn_number = 123456.789;
console.log(totn_number.toLocaleString());
En este ejemplo, declaramos una variable llamada totn_number, a la que se le asigna el valor 123456.789. Luego, llamamos al método toLocaleString() de totn_number para convertir un número a su representación numérica específica del lugar.
Para fines de demostración, escribimos la salida del método toLocaleString() en el registro de la consola del navegador web para mostrar lo que devuelve el método toLocaleString().
Lo siguiente se enviará al registro de la consola del navegador web:
123,456.789
En este ejemplo, la salida del registro de la consola devuelve el valor de cadena “123.456.789”, que es la representación numérica específica de la configuración regional del número 123456.789 (es decir, el valor predeterminado es la configuración regional actual del entorno host).
Especificar el parámetro de configuración regional
También puede proporcionar una etiqueta de idioma BCP 47 al parámetro de configuración regional para cambiar la configuración regional utilizada para convertir números.
Por ejemplo:
var totn_number = 123456.789;
console.log(totn_number.toLocaleString('en-US'));
console.log(totn_number.toLocaleString('en-IN'));
console.log(totn_number.toLocaleString('fr-FR'));
Lo siguiente se enviará al registro de la consola del navegador web:
123,456.789 1,23,456.789 123 456,789
En este ejemplo, la primera salida del registro de la consola devuelve “123.456.789”, que es la representación numérica de EE. UU. (inglés) del número especificado por el parámetro de configuración regional “en-US”.
La segunda salida del registro de la consola devuelve “1,23,456.789”, que es la representación numérica india (inglés) del número especificado por el parámetro de configuración regional “en-IN”.
La tercera salida del registro de la consola devuelve “123?456,789”, que es la representación numérica en francés (francés) del número especificado por el parámetro de configuración regional “fr-FR”.
Especificar parámetros de opción
Finalmente, el método toLocaleString() tiene varias opciones que puede configurar para cambiar la representación del número.
Por ejemplo:
var totn_number = 123456.789;
console.log(totn_number.toLocaleString('en-US', {style:'currency', currency:'USD'}));
console.log(totn_number.toLocaleString('en-IN', {style:'currency', currency:'INR'}));
console.log(totn_number.toLocaleString('fr-FR', {style:'currency', currency:'EUR'}));
Lo siguiente se enviará al registro de la consola del navegador web:
$123,456.79 ₹ 1,23,456.79 123 456,79 €
En este ejemplo, la primera salida del registro de la consola devuelve “$123.456,79”, que es la representación numérica estadounidense (inglés) del número que se muestra en dólares estadounidenses (es decir, dólares estadounidenses). Tenga en cuenta que el valor se ha redondeado a 2 decimales.
La segunda salida del registro de la consola devuelve “₹1,23,456.79”, que es la representación numérica india (inglés) del número que se muestra en moneda INR (es decir, rupia india). Tenga en cuenta que el valor se ha redondeado a 2 decimales.
La tercera salida del registro de la consola devuelve “123 456,79 €”, que es la representación numérica en francés (Francia) del número que se muestra en la moneda del euro (es decir, el euro). Tenga en cuenta que el valor se ha redondeado a 2 decimales.