Форматировать число
Робот «Форматировать число» превращает число в читаемую строку в бизнес-процессах и роботах Битрикс24: задаются количество знаков после запятой, разделитель дробной части и разделитель тысяч. Понимает «1 500,50» на входе. Возвращает отформатированную строку, нормализованное число и признак «Число распознано» Y/N.
Робот форматирует число для показа человеку — из «1234567.5» получается «1 234 567,50», которую не стыдно подставить в письмо или документ. На вход подаются число (запятая как десятичный разделитель и пробелы внутри понимаются), количество знаков после запятой (по умолчанию 2), разделитель дробной части (по умолчанию запятая) и разделитель тысяч: space — пробел, none — без разделителя, либо любой свой символ. Типовые случаи применения: подставить сумму сделки в коммерческое предложение; вывести бюджет в уведомлении руководителю без хвоста из шести знаков; привести число к формату перед записью в документ. Если значение не число, возвращается «Число распознано» = N и пустая строка. Возвращает строку, нормализованное число и признак Y/N — используйте их на следующих шагах бизнес-процесса.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Число | string | да | |
| Знаков после запятой (по умолчанию 2) | string | — | |
| Разделитель дробной части (по умолчанию запятая) | string | — | |
| Разделитель тысяч: space — пробел, none — без разделителя, или свой символ (по умолчанию пробел) | string | — |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Отформатированная строка | string |
| Число (нормализованное) | double |
| Число распознано (Y/N) | string |
Сценарий: сумма в коммерческом предложении
- Сделка формирует документ с суммой 1234567.5
- Робот форматирует число: 2 знака, запятая, пробел между тысячами
- В документ подставляется «1 234 567,50» — сумма читается с первого взгляда