CKTIS / JavaScript
Intl.NumberFormat — oblikovanje števil glede na področne nastavitve
Intl.NumberFormat pretvori števila v besedilo glede na področne nastavitve in možnosti oblikovanja. Omogoča nadzor nad združevanjem števk in decimalnimi mesti; format vrne funkcijo, povezano z določenim oblikovalnikom.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
const formatter = new Intl.NumberFormat(locales, options);
formatter.format(value);Intl.NumberFormat ustvari oblikovalnik števil z uporabo locales in options. Spada v standard ECMA-402, ne v API DOM. Oblikovanje ustvari besedilo za prikaz, ne nove številske vrednosti ali razčlenjevalnika lokaliziranih števil.
Intl.NumberFormat.prototype.format je dostopna lastnost: ko jo preberete iz primerka, vrne funkcijo, povezano s tem primerkom. Zato lahko z const format = formatter.format pozneje pokličete format(value) in ne izgubite nastavitev. Isti oblikovalnik lahko uporabite za več vrednosti.
minimumFractionDigits določa najmanjše, maximumFractionDigits pa največje število števk za decimalnim ločilom. Kadar ti omejitvi veljata in obe nastavite na 2, se pri privzeti nastavitvi trailingZeroDisplay: "auto" prikažeta dve števki za decimalnim ločilom, rezultat pa se po potrebi zaokroži. Pri nastavitvi trailingZeroDisplay: "stripIfInteger" se ničle za decimalnim ločilom ne prikažejo, če je zaokroženi rezultat celo število. Pri privzeti nastavitvi roundingPriority: "auto" oblikovalnik prezre obe omejitvi števila decimalnih mest, če določite maximumSignificantDigits. useGrouping: false izklopi združevanje. Slog currency zahteva možnost currency, vendar ne pretvarja menjalnih tečajev.
Primer izrecno izbere en-US in števke latn. Razpoložljivost področnih nastavitev in podrobnosti oblikovanja so lahko odvisne od izvedbe in njenih področnih podatkov. Rezultat preverite v ciljnem brskalniku; razpoložljivost v Node 24 ne dokazuje podpore v brskalniku.
Primeri
const formatter = new Intl.NumberFormat("en-US", {
numberingSystem: "latn",
useGrouping: false,
minimumFractionDigits: 2,
maximumFractionDigits: 2
});
const format = formatter.format;
console.log(format(1234.5));Rezultat
1234.50
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.