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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.