Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje