Функция dateadd позволяет добавить к указанной дате определенное число времени (лет, месяцев, дней, часов, минут, секунд).
Выглядит она следующим образом:
=dateadd([начальная дата], [что добавлять])
В качестве даты можно установить переменные, параметры шаблона, а также поля документа, для которого создан бизнес-процесс. Кроме того можно просто ввести даты вручную или подставить текущее системное время {=System:Now}.
В [что добавлять] можно вводить значения y, m, d, h, i, s — года, месяца, дни, часы, минуты и секунды соответственно. При этом с помощью знаков + и — можно указать даты позднее или ранее начальной. Например:
=dateadd({=Document:DATE_CREATE}, «+1d») — получится значение, равное дате создания документа плюс 1 день.
=dateadd({=Document:DATE_CREATE}, «-21d») — получится значение, равное дате создания документа минус 21 день.
Dateadd не меняет саму дату, для которой она применяется. То есть, если в функции используется дата создания, то сама дата создания никак не меняется, мы просто берем ее значение и прибавляем к ней определенный срок. Поэтому, если важно именно сохранить новое значение, то тогда нужно записывать его отдельную в переменную или т.п.
Пример использования
Один из самых распространенных примеров использования dateadd — создать в бизнес-процессе задачу с крайним сроком, автоматически рассчитывающимся относительно даты начала.
Поставим задачу, на выполнение которой будет отведено 10 дней с момента ее создания.
Для этого в блоке задача в поле Крайний срок введем =dateadd({=System:Now}, «+10d»).
После запуска процесса будет создана задача, в которой крайний срок будет на 10 дней позже даты создания.
Для получения результатов функции в виде текста для уведомлений, задач, записей в живой ленте и т.п. нужно заключить ее в двойные фигурные скобки т.е. {{=dateadd({=Document:DATE_CREATE}, «+1d»)}}.
Рекомендую также прочитать:
- Вычисление значений выражений в параметрах действий
