Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Intl.NumberFormat: opcije za valute i postotke

Oblikujte iznose i omjere prema jezičnim i regionalnim postavkama. Saznajte kada je šifra valute obvezna, zašto 0,125 predstavlja 12,5 % i kako odrediti broj decimalnih mjesta.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

new Intl.NumberFormat(locale, { style: "currency", currency: "USD" }).format(amount)
new Intl.NumberFormat(locale, { style: "percent", minimumFractionDigits: 1, maximumFractionDigits: 1 }).format(ratio)

new Intl.NumberFormat(locale, options) stvara objekt za višekratno oblikovanje; format(value) vraća lokalizirani tekst. Jezične i regionalne postavke utječu, primjerice, na razdjelnike i položaj simbola. Opcija style određuje vrstu prikaza i zadana joj je vrijednost "decimal".

Uz style: "currency" navedite u currency šifru poput "USD". Iznos zadajte u glavnoj novčanoj jedinici, ne u centima: oblikovanje ne preračunava valute. Ako izostavite šifru, nastaje TypeError; ako se šifra ne sastoji od tri ASCII slova, nastaje RangeError. Ispravno zapisana šifra nije nužno dodijeljena nekoj valuti. currencyDisplay bira "symbol" (zadano), "narrowSymbol" (kraći simbol), "code" ili "name". Zadana vrijednost opcije currencySign jest "standard"; "accounting" može prikazati negativne iznose u zagradama, ovisno o jezičnim i regionalnim postavkama.

Uz style: "percent" zadajte omjer: oblikovanje ga množi sa 100 prije zaokruživanja. Za prikaz 12,5 % zadajte 0.125, a ne 12.5. Uz standardni zapis i bez postavki za značajne znamenke, zadani broj decimalnih mjesta ovisi o manjoj jedinici valute (dva za USD), dok je za postotke zadana nula. minimumFractionDigits po potrebi dopunjava nulama, a maximumFractionDigits ograničava broj decimalnih mjesta pri zaokruživanju. Uz zadanu postavku trailingZeroDisplay: "auto" postavite obje opcije na istu vrijednost za prikaz točno toliko decimalnih mjesta. Uz trailingZeroDisplay: "stripIfInteger" decimalni se dio izostavlja ako je zaokruženi rezultat cijeli broj.

Lokalizacijski podaci i podrška izvršnog okruženja mogu se razlikovati. Razmaci i simboli mogu se razlikovati čak i uz iste jezične i regionalne postavke, pa nemojte uspoređivati cijeli lokalizirani niz s unaprijed zadanom vrijednošću. Pomoću formatToParts() pregledajte dijelove prema vrsti.

Primjeri

const locale = "en-US-u-nu-latn";
const money = new Intl.NumberFormat(locale, {
  style: "currency",
  currency: "USD",
  currencyDisplay: "code",
});
const percent = new Intl.NumberFormat(locale, {
  style: "percent",
  minimumFractionDigits: 1,
  maximumFractionDigits: 1,
});

const moneyParts = money.formatToParts(19.9);
const percentParts = percent.formatToParts(0.125);
const valueOf = (parts, type) => parts.find(part => part.type === type)?.value;

console.log(JSON.stringify([
  valueOf(moneyParts, "currency"),
  valueOf(moneyParts, "integer"),
  valueOf(moneyParts, "fraction"),
]));
console.log(JSON.stringify([
  valueOf(percentParts, "integer"),
  valueOf(percentParts, "fraction"),
  percentParts.some(part => part.type === "percentSign"),
]));

Rezultat

["USD","19","90"]
["12","5",true]

Prvi redak prikazuje šifru USD i oba dijela iznosa, uključujući završnu nulu. Drugi prikazuje brojčane dijelove vrijednosti 12,5 % i potvrđuje prisutnost znaka postotka bez provjere točnog znaka ili njegova položaja.

Povezane lekcije

  • JavaScript · Lekcija 24 · Srednje · Verzija: 3

Izvori