Парсер cron-выражений

Во что разворачивается каждое поле

Поле задаёт не одно значение, а целый набор. Обычно достаточно понять, насколько этот набор велик, и вопрос, с которым вы пришли, отпадает сам собой.

Операторы внутри поля: * все значения, 1,5,10 список, 1-5 диапазон, */15 шаг, отсчитываемый от начала диапазона, и 0-45/15 шаг внутри диапазона.

Названия и сокращения тоже принимаются

Названия месяцев и дней недели разбираются и разворачиваются в числа, которым соответствуют: для 30 3 * JAN,JUL 1 в поле месяца будет 1, 7, а в поле дня недели 1. Именованные сокращения разворачиваются в форму из 5 полей раньше всего остального:

@reboot тоже распознаётся, но разворачивать здесь нечего: задача выполняется один раз при запуске машины, поэтому и ближайших запусков у неё не будет.

Предупреждения, которые стоит прочитать

• Ограничены оба поля дня. 0 0 1 * MON не значит «1-го числа, но только если это понедельник». Когда ограничены оба поля дня, стандартный cron объединяет их по ИЛИ, поэтому такая строка сработает и 1-го числа каждого месяца, и каждый понедельник. Парсер выводит это предупреждение, а предпросмотр запусков следует тому же правилу ИЛИ.
• Дата, которой не бывает. 0 0 30 2 * просит 30 февраля. Синтаксически выражение корректно, и cron его примет, но сработать оно не сможет никогда. Парсер прямо об этом сообщает, вместо того чтобы показать пустой список без объяснений.
• Операторы Quartz. L (последний), W (ближайший рабочий день), # (день недели по номеру в месяце) и ? относятся к расширениям Quartz, а не к стандартному crontab. Внутри строки из 5 полей они распознаются и помечаются, а в поле вместо списка значений указано, что это оператор Quartz. Время запусков не рассчитывается, потому что стандартный cron такую строку не выполнил бы вовсе.

Что отклоняется сразу

• Неверное число полей. Строка Quartz из 6 полей с секундами или из 7 полей с годом отклоняется по количеству полей.
• Значения вне диапазона, например минута 75 или месяц 13.
• Убывающий диапазон вроде 5-1.
• Нулевой шаг, например */0.

В каждом отказе названы поле и значение, которые его вызвали, поэтому вы правите одну деталь, а не переписываете строку целиком.

Часовой пояс

Ближайшие запуски рассчитываются в браузере, в том часовом поясе, который выставлен на вашем устройстве. Сам crontab работает по времени той машины, где он установлен, поэтому, если сервер живёт по UTC, а вы нет, перед сравнением сдвиньте время на нужную разницу.