CKTIS / JavaScript
Intl.NumberFormat — formátování čísel podle místního nastavení
Intl.NumberFormat převádí čísla na text podle místního nastavení a možností formátování. Umožňuje řídit například seskupování číslic a desetinná místa; format vrací funkci navázanou na konkrétní formátovač.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const formatter = new Intl.NumberFormat(locales, options);
formatter.format(value);Intl.NumberFormat vytváří formátovač čísel pomocí locales a options. Patří do standardu ECMA-402, nikoli do DOM API. Formátování vytváří text určený k zobrazení, ne novou číselnou hodnotu ani parser lokalizovaných čísel.
Intl.NumberFormat.prototype.format je přístupová vlastnost: při načtení z instance vrací funkci navázanou na tuto instanci. Díky tomu lze pomocí const format = formatter.format později volat format(value) bez ztráty nastavení. Stejný formátovač můžete použít pro více hodnot.
minimumFractionDigits určuje minimální a maximumFractionDigits maximální počet číslic za desetinným oddělovačem. Pokud se tyto limity použijí a oba nastavíte na 2, při výchozím nastavení trailingZeroDisplay: "auto" se zobrazí dvě číslice za desetinným oddělovačem a výsledek se v případě potřeby zaokrouhlí. Při nastavení trailingZeroDisplay: "stripIfInteger" se nuly za desetinným oddělovačem nezobrazí, pokud je zaokrouhlený výsledek celé číslo. Při výchozím nastavení roundingPriority: "auto" formátovač oba limity počtu desetinných míst ignoruje, pokud zadáte maximumSignificantDigits. useGrouping: false vypne seskupování. Styl currency vyžaduje možnost currency, ale nepřevádí směnné kurzy.
Příklad výslovně vybírá en-US a číslice latn. Dostupnost místních nastavení a podrobnosti formátování mohou záviset na implementaci a jejích lokalizačních datech. Výsledek ověřte v cílovém prohlížeči; dostupnost v Node 24 nedokazuje podporu v prohlížeči.
Pří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ýsledek
1234.50
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.