Функція dateadd

Рейтинг:

Автор: Валерія Башкірова

21 Травня 2019

Функція 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")}}.

Також варто прочитати: