У каждого языка свои нормы записи чисел: разделитель дробной части, группировка разрядов, обозначение тысяч и миллионов. Форматтеры применяют нормы текущей локали и обновляют запись при переключении языка. Применяйте их везде, где числа видит пользователь.

В больших числах разряды группируют по три, считая справа. В тексте используйте пайп 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}
ПараметрПо умолчаниюОписание
minIntegerDigits1Минимальное количество целых разрядов
minFractionDigits0Минимальное количество дробных разрядов
maxFractionDigits3Максимальное количество дробных разрядов
useGroupingtrueВключает или выключает группировку разрядов

Например, '4.0-2-false' оставляет 4 целых и до 2 дробных разрядов и отключает группировку.

digitsInfokbqNumberkbqTableNumber
—1,000.1231,000.123
5.5-501,000.1230001,000.12300
4.5-51,000.123001,000.12300
4.0-21,000.121,000.12
4.0-2-false1000.121000.12
4.0-01,0001,000

Пайп kbqRoundNumber отображает большие числа в сокращенном виде: тысячу — как K, миллион — как M, миллиард — как B и так далее.

Full numberFormatted value
1,0001.0K
10,00010K
100,000100K
1,000,0001.0M
10,000,00010M
100,000,000100M
1,000,000,0001.0B

По умолчанию пайпы используют текущую локаль приложения. Передайте код локали последним аргументом, чтобы отформатировать значение в указанной локали независимо от активной.

LocalekbqNumberkbqRoundNumber
ru-RU1 234 567,891,2 М
en-US1,234,567.891.2M
es-LA1 234 567,891,2M
pt-BR1.234.567,891,2 mi
Предложения по улучшению
Если вы нашли ошибку или хотите доработать статью, создайте запрос на GitHub.