Интервал CRON-выражения

CRON-выражение используется для настройки определенных экземпляров триггера, в основном для повторяющегося срабатывания по расписанию. Оно представляет собой строку, состоящую из 6 или 7 полей, представляющих отдельные значения расписания. Эти поля разделены пробелами и содержат любые разрешенные значения в разных сочетаниях.

CRON-выражение может быть простым, например: * * * * ? *, или более сложным, например: 0/5 14,18,3-39,52 * ? JAN,MAR,SEP MON-FRI 2012-2020

Список значений, которые можно использовать в CRON-выражении:

Имя	Обязательно	Значение	Разрешенные специальные символы
Секунды	Да	0-59	, - * / R
Минуты	Да	0-59	, - * / R
Часы	Да	0-23	, - * / R
День месяца	Да	1-31	, - * / ? L W
Месяц	Да	1–12 или JAN-DEC	, - */
День недели	Да	0–6 или SUN-SAT	, - / ? L #
Год	Да	1970-2099	, - * /

Синтаксис CRON-выражения следующий:

┌────────── Секунды (0–59)

│ ┌────────── Минуты (0–59)

│ │ ┌────────── Часы (0–23)

│ │ │ ┌────────── День месяца (1–31)

│ │ │ │ ┌────────── Месяц (1–12 или JAN-DEC)

│ │ │ │ │ ┌────────── День недели (0–6 или SUNSAT) (например, 0 равнозначен SUN)

│ │ │ │ │ │ ┌────────── Год

│ │ │ │ │ │ │

* * * * * ? *

•Значение 0 0 0 означает полночь (секунды, минуты, часы).

•Используйте символ ? при невозможности определить значение из-за того, что оно определено в другом поле (число месяца или день недели).

•Символ * означает каждый соответствующий период (секунды, минуты, часы, число месяца, месяц, день недели, год).

•Значение SUN означает «в воскресенье».

Названия месяцев и дней недели не чувствительны к регистру. Например, MON равнозначно mon, а JAN равнозначно jan.

Специальные символы

Запятая (,)

Запятые используются для разделения элементов списка. Например, строка «MON,WED,FRI» в 6-м поле (день недели) означает «понедельники, среды и пятницы».

Дефис (-)

Задает диапазоны. Например, 2012-2020 обозначает каждый год от 2012 до 2020 включительно.

Подстановочный знак (*)

Служит для выбора всех возможных значений в пределах поля. Например, * в поле минут означает каждую минуту. Подстановочный знак нельзя использовать в поле дня недели.

Вопросительный знак (?)

При выборе определенного дня можно указать либо число месяца, либо день недели. То и другое одновременно указать нельзя. Если вы указали число месяца, в качестве дня недели необходимо указать ?, и наоборот. Например, если нужно, чтобы триггер сработал в определенный день месяца (скажем, 10-й), но без разницы, какой это будет день недели, укажите 10 в поле числа месяца и ? в поле дня недели.

Решетка (#)

Служит для указания N-го дня в месяце. Например, значение 4#3 в поле дня недели означает третий четверг месяца (день 4 = четверг, а #3 = 3-й четверг в месяце). Если вы указали #5, а в месяце отсутствует 5-й заданный день недели, триггер в этом месяце не сработает.

Косая черта (/)

Описывает шаг диапазона. Например, 3-59/15 во 2-м поле (минуты) обозначает третью минуту часа и каждые 15 минут в дальнейшем.

Последний (L)

При использовании в поле дня недели позволяет указывать такие конструкции, как последняя пятница (5L) заданного месяца. В поле числа месяца указывает последний день месяца. Например, день 31 для января, день 28 для февраля в невисокосные годы.

Рабочий день (W)

Символ W разрешен в поле числа месяца. Этот символ служит для указания рабочего дня (с понедельника по пятницу), ближайшего к заданному дню. Например, если указать значение 15W в поле числа месяца, это будет означать ближайший рабочий день к 15-му числу месяца. Таким образом, если 15-е число — суббота, триггер сработает в пятницу 14-го. Если 15-е число — воскресенье, триггер сработает в понедельник 16-го. Однако если указать число месяца 1W, когда 1-е число — суббота, триггер сработает в понедельник 3-го числа, так как он не перепрыгивает через границу месяца.

Символы L и W можно также комбинировать в поле числа месяца (LW), что означает последний рабочий день месяца.

Случайный (R)

R — это специальный символ CRON-выражений ESET PROTECT On-Prem, который позволяет указывать произвольные моменты времени. Например, триггер R 0 0 * * ? * срабатывает каждый день в 00:00, но в случайную секунду (0–59).

Рекомендуется использовать рандомизированные моменты времени, чтобы не допустить подключения всех агентов ESET Management к ESET PROTECT Server в один и тот же момент.

Реальные примеры, иллюстрирующие некоторые разновидности CRON-выражения.

CRON-выражение	Описание
0 0 12 * * ? *	Срабатывание в 12:00 (полдень) каждый день.
R 0 0 * * ? *	Срабатывание в 00:00, но в случайную секунду (0–59) каждый день.
R R R 15W * ? *	Срабатывание 15-го числа каждого месяца в случайное время (секунды, минуты, часы). Если 15-е число — суббота, триггер сработает в пятницу 14-го. Если 15-е число — воскресенье, триггер сработает в понедельник 16-го.
0 15 10 * * ? 2016	Срабатывание в 10:15 каждый день в течение всего 2016 года.
0 * 14 * * ? *	Срабатывание каждую минуту с 14:00 до 14:59 каждый день.
0 0/5 14 * * ? *	Срабатывание каждые 5 минут с 14:00 до 14:55 каждый день.
0 0/5 14,18 * * ? *	Срабатывание каждые 5 минут с 14:00 до 14:55, а также каждые 5 минут с 18:00 до 18:55 каждый день.
0 0-5 14 * * ? *	Срабатывание каждую минуту с 14:00 до 14:59 каждый день.
0 10,44 14 ? 3 WED *	Срабатывание в 14:10 и 14:44 каждую среду марта.
0 15 10 ? * MON-FRI *	Срабатывание в 10:15 по будням (в понедельник, вторник, среду, четверг и пятницу).
0 15 10 15 * ? *	Срабатывание в 10:15, 15 числа каждого месяца.
0 15 10 ? * 5L *	Срабатывание в 10:15 в последнюю пятницу каждого месяца.
0 15 10 ? * 5L 2016-2020	Срабатывание в 10:15 в последнюю пятницу каждого месяца с 2016 по 2020 гг. включительно.
0 15 10 ? * 5#3 *	Срабатывание в 10:15 в 3-ю пятницу каждого месяца.
0 0 * * * ? *	Срабатывание ежечасно, ежедневно.

˄˅