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

CKTIS / JavaScript

Intl.NumberFormat — форматиране на числа според локала

Intl.NumberFormat преобразува числа в текст според локал и опции за форматиране. Позволява да управлявате, наред с други неща, групирането на цифрите и десетичните знаци; format връща функция, обвързана с конкретен форматиращ обект.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

const formatter = new Intl.NumberFormat(locales, options);
formatter.format(value);

Intl.NumberFormat създава форматиращ обект за числа с помощта на locales и options. Той е част от ECMA-402, а не от DOM API. Форматирането създава текст за показване, а не нова числова стойност или парсер за локализирани числа.

Intl.NumberFormat.prototype.format е аксесорна характеристика: при прочитане от екземпляр тя връща функция, обвързана с този екземпляр. Затова const format = formatter.format ви позволява по-късно да извикате format(value), без да губите настройките. Можете да използвате повторно същия форматиращ обект за множество стойности.

minimumFractionDigits задава минималния, а maximumFractionDigits — максималния брой цифри след десетичния разделител. Когато тези ограничения се прилагат и и двете са зададени на 2, при настройката по подразбиране trailingZeroDisplay: "auto" се показват две цифри след десетичния разделител, като резултатът при нужда се закръгля. При trailingZeroDisplay: "stripIfInteger" нулите след десетичния разделител се пропускат, ако закръгленият резултат е цяло число. При настройката по подразбиране roundingPriority: "auto", ако зададете maximumSignificantDigits, форматиращият обект пренебрегва и двете ограничения за броя на десетичните знаци. useGrouping: false изключва групирането. Стилът currency изисква опция currency, но не преобразува валутни курсове.

Примерът изрично избира en-US и цифрите latn. Наличността на локали и подробностите за форматиране може да зависят от реализацията и нейните локални данни. Проверете резултата в целевия браузър; наличността в Node 24 не доказва поддръжка в браузър.

Примери

const formatter = new Intl.NumberFormat("en-US", {
  numberingSystem: "latn",
  useGrouping: false,
  minimumFractionDigits: 2,
  maximumFractionDigits: 2
});
const format = formatter.format;
console.log(format(1234.5));

Резултат

1234.50

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници