Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Intl.NumberFormat — formato de números según la configuración regional

Intl.NumberFormat convierte números en texto usando una configuración regional y opciones de formato. Permite controlar, entre otros aspectos, la agrupación de dígitos y los decimales; format devuelve una función vinculada a un formateador concreto.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

const formatter = new Intl.NumberFormat(locales, options);
formatter.format(value);

Intl.NumberFormat crea un formateador de números a partir de locales y options. Pertenece a ECMA-402, no a la API DOM. El formato produce texto para mostrar, no un nuevo valor numérico ni un analizador de números localizados.

Intl.NumberFormat.prototype.format es una propiedad de acceso: al leerla desde una instancia, devuelve una función vinculada a esa instancia. Por eso, const format = formatter.format permite llamar después a format(value) sin perder la configuración. Puedes reutilizar el mismo formateador para varios valores.

minimumFractionDigits establece el número mínimo y maximumFractionDigits el máximo de dígitos después del separador decimal. Cuando se aplican estos límites, si se fijan ambos en 2, se muestran dos dígitos después del separador decimal con el ajuste predeterminado trailingZeroDisplay: "auto", con redondeo si es necesario. Con trailingZeroDisplay: "stripIfInteger", se omiten los ceros después del separador decimal si el resultado redondeado es un entero. Con el ajuste predeterminado roundingPriority: "auto", si se especifica maximumSignificantDigits, el formateador ignora ambos límites de decimales. useGrouping: false desactiva la agrupación. El estilo currency requiere una opción currency, pero no convierte tipos de cambio.

El ejemplo selecciona explícitamente en-US y los dígitos latn. La disponibilidad de configuraciones regionales y los detalles del formato pueden depender de la implementación y de sus datos regionales. Comprueba el resultado en el navegador de destino; que esté disponible en Node 24 no demuestra que sea compatible con el navegador.

Ejemplos

const formatter = new Intl.NumberFormat("en-US", {
  numberingSystem: "latn",
  useGrouping: false,
  minimumFractionDigits: 2,
  maximumFractionDigits: 2
});
const format = formatter.format;
console.log(format(1234.5));

Resultado

1234.50

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes