JavaScript: método Number toLocaleString()

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:

  • buscar
  • mejor ajuste (predeterminado)
estilo

Determina el estilo de formato a utilizar. Puede ser uno de los siguientes valores:

  • decimal – formato de número general (predeterminado)
  • Moneda – formato de moneda
  • porcentaje – formato de porcentaje
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:

  • símbolo: use un símbolo de moneda específico de la región, por ejemplo, “$” (predeterminado)
  • Código: use el código de moneda ISO, por ejemplo, “USD”
  • nombre: use un nombre de moneda específico de la configuración regional, por ejemplo, “dólar”
uso de agrupación

Determina si se muestran los separadores de agrupación. Puede ser uno de los siguientes valores:

  • verdadero: se mostrará el separador de agrupación (predeterminado)
  • falso: no muestra los separadores de agrupación
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.

(Visited 86 times, 1 visits today)