Модуль:ReformatNumber/документація

Загальний опис

Модуль описує функцію reformatNumber, яка допомагає краще оформити число (передане першим параметром), зокрема (перелік неостаточний і може змінюватися):

• замінює роздільник між цілою й дробовою частиною на правильний («,»);
• відокремлює кожні три цифри цілої частини правильним чином (нерозривним пробілом);
• замінює мінус на правильний («−»);
• правильно оформлює слова «тис.», «млн» тощо (крапка після «тис.», але не після інших слів; нерозривний пробіл перед словом).

Приклади:

• «{{#invoke:ReformatNumber|reformatNumber|123}}» дає «123» [1]

• «{{#invoke:ReformatNumber|reformatNumber|123.00}}» дає «123,00» [2]

• «{{#invoke:ReformatNumber|reformatNumber|1234567}}» дає «1 234 567» [3]

• «{{#invoke:ReformatNumber|reformatNumber|-123}}» дає «−123» [4]

• «{{#invoke:ReformatNumber|reformatNumber|5 тис}}» дає «5 тис.» [5]

• «{{#invoke:ReformatNumber|reformatNumber|5млн.}}» дає «5 млн» [6]

.

Додаткові можливості

Необов'язковий параметр preUnit дозволяє задати одиницю вимірювання, яка пишеться до числа, але після мінуса (якщо він присутній). В українській мові зазвичай одиниці так не пишуть (хоча триває дискусія, як краще: «₴123» чи «123 ₴»), але про всяк випадок така можливість передбачена. Можливостей задавати одиниці вимірювання які пишеться після числа (як звичайно) або до-числа-й-до-мінуса не передбачено, оскільки такі одиниці вимірювання можна легко написати просто зовні (до чи після) виклику функції. Приклади:

• «₴{{#invoke:ReformatNumber|reformatNumber|-123}}» дає «₴−123»;
• «{{#invoke:ReformatNumber|reformatNumber|-123}} ₴» дає «−123 ₴»;
• «{{#invoke:ReformatNumber|reformatNumber|-123|preUnit=₴}}» дає «−₴123».

Повний перелік параметрів

Повний перелік параметрів

Назва параметра	Номер параметра	Обов'язковий?	Тлумачення
number	1	Так	Число, яке потрібно відформатувати
preUnit	2	Ні	Одиниця вимірювання, яка писатиметься до числа, але після мінуса (якщо він присутній)