CKTIS / JavaScript
Intl.NumberFormat — formátovanie čísel podľa miestneho nastavenia
Intl.NumberFormat prevádza čísla na text podľa miestneho nastavenia a možností formátovania. Umožňuje riadiť napríklad zoskupovanie číslic a desatinné miesta; format vracia funkciu naviazanú na konkrétny formátovač.
Verzia: 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 vytvára formátovač čísel pomocou locales a options. Patrí do štandardu ECMA-402, nie do DOM API. Formátovaním vzniká text na zobrazenie, nie nová číselná hodnota ani parser lokalizovaných čísel.
Intl.NumberFormat.prototype.format je prístupová vlastnosť: pri načítaní z inštancie vráti funkciu naviazanú na túto inštanciu. Preto možno pomocou const format = formatter.format neskôr zavolať format(value) bez straty nastavení. Rovnaký formátovač môžete používať pre viacero hodnôt.
minimumFractionDigits určuje minimálny a maximumFractionDigits maximálny počet číslic za desatinným oddeľovačom. Ak sa tieto limity použijú a oba nastavíte na 2, pri predvolenom nastavení trailingZeroDisplay: "auto" sa zobrazia dve číslice za desatinným oddeľovačom a výsledok sa v prípade potreby zaokrúhli. Pri nastavení trailingZeroDisplay: "stripIfInteger" sa nuly za desatinným oddeľovačom nezobrazia, ak je zaokrúhlený výsledok celé číslo. Pri predvolenom nastavení roundingPriority: "auto" formátovač oba limity počtu desatinných miest ignoruje, ak zadáte maximumSignificantDigits. useGrouping: false vypne zoskupovanie. Štýl currency vyžaduje možnosť currency, ale neprepočítava výmenné kurzy.
Príklad výslovne vyberá en-US a číslice latn. Dostupnosť miestnych nastavení a podrobnosti formátovania môžu závisieť od implementácie a jej lokalizačných údajov. Výsledok skontrolujte v cieľovom prehliadači; dostupnosť v Node 24 nedokazuje podporu v prehliadači.
Príklady
const formatter = new Intl.NumberFormat("en-US", {
numberingSystem: "latn",
useGrouping: false,
minimumFractionDigits: 2,
maximumFractionDigits: 2
});
const format = formatter.format;
console.log(format(1234.5));Výsledok
1234.50
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.