Неверный разделитель тысяч обычно появляется не в арифметике, а на границе данных и отображения. Сумма хранится числом или в minor units, валюта передаётся отдельным кодом, а строку для человека строит локализованный formatter. Не заменяйте запятую на пробел вручную: в другой locale эта запятая может быть десятичным знаком, а группировка может иметь другой размер.
Снимите диагностический набор прямо на проблемной странице: исходное числовое значение, currency, запрошенную и фактически resolved locale, параметры formatter и кодовые точки полученной строки. Обычный пробел, неразрывный пробел и узкий неразрывный пробел выглядят похоже, но по-разному ведут себя в сравнении, переносе и копировании.
На каждом слое сумма имеет свой тип
| Слой | Корректное представление | Частая ошибка |
|---|---|---|
| база | numeric/decimal или integer minor units | хранить локализованную строку |
| API | amount плюс currency | посылать `1 234,50 ₽` как значение |
| locale resolution | явный BCP 47 tag | зависеть от языка случайного узла |
| UI formatter | Intl.NumberFormat | цепочка regex и replace |
| CSV/экспорт | отдельный контракт формата | копировать HTML-текст без правил |
Строка из API неудобна для сортировки, суммирования и повторного форматирования. Передавайте, например, `amount_minor: 123450` и `currency: RUB`, а преобразование в major units выполняйте в одном проверенном модуле. Для валют с разным числом дробных знаков используйте справочные правила formatter, а не постоянное деление на 100 для всех кодов.
Intl.NumberFormat получает и locale, и назначение
ECMA-402 определяет объект `Intl.NumberFormat`, а данные о символах и группировке берутся из локализационной реализации. Явно передайте locale и стиль. После создания вызовите `resolvedOptions()`: это покажет, какую locale среда действительно выбрала после fallback. Один и тот же вызов используйте для таблицы, карточки и итоговой строки, чтобы компоненты не расходились.
const amount = 1234567.89;
const formatter = new Intl.NumberFormat('ru-RU', {
style: 'currency',
currency: 'RUB',
useGrouping: true,
});
const text = formatter.format(amount);
const parts = formatter.formatToParts(amount);
const resolved = formatter.resolvedOptions();
// parts позволяют найти group и decimal без догадки о символе- Не передавать денежное значение через двоичный float, если точность расчёта критична.
- Не добавлять символ валюты конкатенацией после уже отформатированного числа.
- Не нормализовать пробелы в готовой строке общим `.replace(/\s/g, ...)`.
- Не определять locale только по IP, если пользователь уже выбрал язык или регион.
Пробел может быть частью корректного результата
Unicode CLDR описывает отдельные символы decimal и group, а также первичный и вторичный размер группировки. Поэтому ожидаемый вид нельзя свести к правилу «каждые три цифры разделить запятой». В некоторых локалях группировка отличается, а пробельный разделитель бывает неразрывным. CSS, шрифт или копирование в буфер могут сделать различие заметным только у части пользователей.
Чтобы доказать проблему, выведите кодовые точки частей с типом `group` и `decimal`. Если formatter возвращает ожидаемый символ, но экран показывает другой, ищите последующее преобразование, HTML entity, функцию маски или библиотеку таблицы. Если `resolvedOptions().locale` неожиданна, чините выбор locale до formatter.
SSR и браузер должны согласовать один контракт
При серверном рендеринге locale должна приходить из того же пользовательского контекста, что и на клиенте. Иначе сервер отдаёт `en-US`, браузер пересчитывает `ru-RU`, и при hydration строка меняется. Зафиксируйте locale в данных страницы или выполняйте форматирование только на одном согласованном этапе. Версии ICU на разных средах тоже записывают в диагностике при редком расхождении.
- Сравнить raw amount и currency до форматирования на сервере и клиенте.
- Записать requested и resolved locale в обеих средах.
- Сравнить массивы `formatToParts`, включая тип и code point.
- Проверить, не проходит ли строка через маску, шаблон или sanitization.
- Отдельно проверить печать, PDF и CSV: у них могут быть другие требования.
Тесты проверяют смысл частей, а не похожий пробел
Набор тестов включает положительное и отрицательное значение, ноль, крупную сумму, дробную часть и несколько locale. Для UI полезно утверждать currency, integer, group и decimal parts, а не вставлять в expected невидимый символ из редактора. Snapshot строки допустим как дополнительная проверка в зафиксированной версии runtime, но он не заменяет семантический тест.
Исправление принято, когда одно числовое значение даёт согласованный формат в карточке, таблице, SSR и после обновления страницы; сортировка остаётся числовой, а экспорт следует своему документированному контракту. Если бизнес требует нестандартный разделитель, это отдельный формат продукта: реализуйте его через parts и тесты, явно понимая, что результат уже не является обычным форматом выбранной locale.