Значение параметра даты

Описание

Условие предоставляет возможность проверки значения параметра на указанное количество единиц времени относительно текущей даты.

automation builder conditions date value
Рис. 1. Общий вид

Поддерживаемые настройки

Параметр

Параметр типа процесса. В выпадающем списке можно выбрать один из параметров типа date, datetime.

Оператор

В выпадающем списке можно выбрать одно из значений:

  • Ранее

  • Ранее или равно

  • Позднее

  • Позднее или равно

Количество

Смещение относительно выбранной единицы времени.

Единица времени

Список возможных значений зависит от конфигурации используемого параметра.

  • Параметр типа date:

    • Год

    • Месяц

    • День

  • Параметр типа datetime:

    • Год

    • Месяц

    • День

    • Час (если в конфигурации параметра указано type=ymdh/ymdhm/ymdhms)

    • Минута (если в конфигурации параметра указано type=ymdhm/ymdhms)

    • Секунда (если в конфигурации параметра указано type=ymdhms)

В случае, если в конфигурации не был указан шаблон даты, то используется ymd
Единица времени предоставляется после выбора параметра из списка значений
Если в конфигурации указан шаблон ymdh, то даты сравниваться будут со всеми единицами времени до заданной. То есть год, месяц, день и час(без минуты и секунды)
Условие не выполнится, если отсутствует значение параметра

Примеры

Пример с оператором Позднее

automation builder conditions date value example 1
Рис. 2. Пример использования параметров с оператором Позднее

При выборе соответствующих параметров, механика проверки условия будет следующей:

  1. Проверяется шаблон даты в конфигурации параметра(по умолчанию ymd)

  2. Добавляется к текущей дате указанная точность времени к соответствующей единице(к часам)

  3. Сравниваются даты с усеченными единицами времени, согласно указанному шаблону в конфигурации параметра

Например:

В конфигурации параметра указано type=ymdh

Текущая дата: 2023-09-12 12:45:01

Дата параметра: 2023-09-12 23:37:06

После добавления 10 часов, текущая дата будет равна 2023-09-12 22:45:01.

Далее даты преобразуются до соответствующей единицы времени(час):

Текущая дата: 2023-09-12 22:00

Дата параметра: 2023-09-12 23:00

Обратите внимание, у дат сравнивать будут не только часы, а поочередно каждые единицы времени(в нашем случае год, месяц, день и потом час).

Таким образом, при сравнении усеченных дат 2023-09-12 22:00(текущая дата) и 2023-09-12 23:00(дата параметра), событие выполнится, так как дата параметра позднее на 1(23-22) час текущей даты.

Пример с оператором Ранее

automation builder conditions date value example 2
Рис. 3. Пример использования параметров с оператором Ранее

В конфигурации параметра указано type=ymdhm

Текущая дата: 2023-09-12 12:45:01

Дата параметра: 2023-09-12 12:50:06

  1. Добавляем 12 минут к текущей дате - 2023-09-12 12:57:01

  2. Сравниваем усеченные даты(до минуты) 2023-09-12 12:57 и 2023-09-12 12:50

Таким образом, заданное правило выполнится, так как дата параметра ранее на 7(57-50) минут текущей даты.