Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri