KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Intl.NumberFormat — getalnotatie volgens de landinstelling

Intl.NumberFormat zet getallen om in tekst met een landinstelling en opmaakopties. Je kunt onder meer cijfergroepering en decimalen instellen; format geeft een functie terug die aan een specifieke formatter is gebonden.

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

Syntax

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

Intl.NumberFormat maakt een getalformatter op basis van locales en options. Het hoort bij ECMA-402, niet bij de DOM-API. De opmaak levert tekst voor weergave op, geen nieuwe numerieke waarde en geen parser voor gelokaliseerde getallen.

Intl.NumberFormat.prototype.format is een accessor-eigenschap: als je deze bij een instantie uitleest, krijg je een functie terug die aan die instantie is gebonden. Daardoor kun je met const format = formatter.format later format(value) aanroepen zonder de instellingen kwijt te raken. Je kunt dezelfde formatter voor meerdere waarden gebruiken.

minimumFractionDigits stelt het minimum en maximumFractionDigits het maximumaantal cijfers na het decimaalteken in. Als deze grenzen gelden en je beide op 2 zet, toont de formatter bij de standaardinstelling trailingZeroDisplay: "auto" twee cijfers na het decimaalteken, met afronding indien nodig. Met trailingZeroDisplay: "stripIfInteger" blijven de nullen na het decimaalteken weg als het afgeronde resultaat een geheel getal is. Bij de standaardinstelling roundingPriority: "auto" negeert de formatter beide grenzen voor het aantal decimalen als je maximumSignificantDigits opgeeft. useGrouping: false schakelt groepering uit. De stijl currency vereist een optie currency, maar rekent geen wisselkoersen om.

Het voorbeeld kiest expliciet en-US en cijfers van het systeem latn. Welke landinstellingen beschikbaar zijn en hoe de opmaak er precies uitziet, kan afhangen van de implementatie en de bijbehorende taalgegevens. Controleer het resultaat in de doelbrowser; beschikbaarheid in Node 24 bewijst geen ondersteuning in browsers.

Voorbeelden

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

Resultaat

1234.50

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen