Процент
Поле «Процент» — для долей: доходности, маржи, ставки налога. Главный вопрос — в каком виде хранить значение.
Договорённость: 0.05 vs 5
⚠️ Уточнить: на момент написания документации точное поведение поля «Процент» (хранит ли оно
0.05или5и где находится умножение на 100) не подтверждено в коде. Ниже описана общая логика Invest и совместимость с финансовыми формулами; перед массовым вводом данных проверьте, как поле ведёт себя в редакторе и в виджете KPI.
Что точно известно:
- Финансовые формулы (
roi,cagr,cap_rate,gross_yield,net_yield,npv,irr) возвращают дробь: 0.05 = 5 %. UI умножает на 100 при отображении. - В формулах для арифметики используйте именно дробь:
amount * 0.06(а неamount * 6).
Когда использовать
- Доходность, маржа, заполняемость.
- Прогресс к цели (0.0–1.0).
- Налоговая ставка.
В формулах
- Все операции, что и для «Числа».
- Сравнение:
current_amount / target_amount >= 0.9(«достигли 90% цели»). - Конвертация в число: умножьте на 100 при необходимости —
percent_field * 100.
Частые ошибки
- Хранят
5и применяют к немуroi(...). Формула вернёт долю — 0.0X. При выводе KPI получите0%вместо5%. Согласовывайте, что во всём датасете «Процент» хранится одинаково. - Делят на 100 в формуле и в виджете одновременно. В результате процент в 10000 раз меньше.