База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Intl.NumberFormat: настройки за валути и проценти

Форматирайте суми и съотношения според езиковите и регионалните настройки. Научете кога кодът на валутата е задължителен, защо 0,125 означава 12,5% и как да зададете броя на дробните цифри.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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) създава обект за многократно форматиране; format(value) връща локализиран текст. Езиковите и регионалните настройки влияят например на разделителите и мястото на символите. style определя вида на представяне и по подразбиране е "decimal".

При style: "currency" задайте в currency код като "USD". Подайте сумата в основната парична единица, а не в центове: форматирането не превалутира суми. Липсващият код предизвиква TypeError, а код, който не се състои от три ASCII букви, предизвиква RangeError. Правилно изписаният код не е непременно присвоен на валута. currencyDisplay избира "symbol" (по подразбиране), "narrowSymbol" (по-кратък символ), "code" или "name". Стойността по подразбиране на currencySign е "standard"; "accounting" може да показва отрицателните суми в скоби според езиковите и регионалните настройки.

При style: "percent" подайте съотношение: форматирането го умножава по 100 преди закръгляне. За да покажете 12,5%, подайте 0.125, а не 12.5. При стандартен запис и без настройки за значещи цифри броят на дробните цифри по подразбиране зависи от дробната парична единица (две за USD), докато за процентите е нула. minimumFractionDigits допълва с нули при нужда, а maximumFractionDigits ограничава броя на дробните цифри при закръгляне. При настройката по подразбиране trailingZeroDisplay: "auto" задайте една и съща стойност и на двете настройки, за да покажете точно толкова дробни цифри. При trailingZeroDisplay: "stripIfInteger" дробната част се пропуска, ако закръгленият резултат е цяло число.

Данните за локализация и поддръжката в средата за изпълнение може да се различават. Интервалите и символите могат да са различни дори при едни и същи езикови и регионални настройки, затова не сравнявайте целия локализиран низ с фиксирана стойност. Използвайте formatToParts(), за да проверявате отделните части по вид.

Примери

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"),
]));

Резултат

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

Първият ред показва кода USD и двете части на сумата, включително крайната нула. Вторият показва числовите части на 12,5% и потвърждава наличието на знак за процент, без да проверява точния символ или мястото му.

Свързани уроци

  • JavaScript · Урок 24 · Средно · Версия: 3

Източници