У каждого языка свои нормы записи чисел: разделитель дробной части, группировка разрядов, обозначение тысяч и миллионов. Форматтеры применяют нормы текущей локали и обновляют запись при переключении языка. Применяйте их везде, где числа видит пользователь.
В больших числах разряды группируют по три, считая справа. В тексте используйте пайп kbqNumber, в таблицах — kbqTableNumber. Пайпы отличаются порогом, с которого начинается группировка.
kbqNumber группирует разряды в числах от 10 000, то есть начиная с пяти разрядов: 1234, 56 789, 987 654, 1 000 000 000. В тексте короткое число без разделителя читается естественнее.
kbqTableNumber отделяет разряды всегда: 1 234, 56 789, 987 654, 1 000 000 000. В таблице ровные столбцы позволяют сравнивать значения по разрядам сверху вниз.
Оба пайпа принимают необязательную строку digitsInfo, которая задает количество целых и дробных разрядов:
{minIntegerDigits}.{minFractionDigits}-{maxFractionDigits}-{useGrouping}
| Параметр | По умолчанию | Описание |
|---|---|---|
minIntegerDigits |
1 |
Минимальное количество целых разрядов |
minFractionDigits |
0 |
Минимальное количество дробных разрядов |
maxFractionDigits |
3 |
Максимальное количество дробных разрядов |
useGrouping |
true |
Включает или выключает группировку разрядов |
Например, '4.0-2-false' оставляет 4 целых и до 2 дробных разрядов и отключает группировку.
Пайп kbqRoundNumber отображает большие числа в сокращенном виде: тысячу — как K, миллион — как M, миллиард — как B и так далее.
По умолчанию пайпы используют текущую локаль приложения. Передайте код локали последним аргументом, чтобы отформатировать значение в указанной локали независимо от активной.