Спецсимволы: звёздочка, слэш, диапазоны и @daily

Звёздочка в поле означает весь диапазон значений этого поля: каждая минута, каждый час, каждое число. Сама по себе она редко встречается во всех пяти полях — чаще её комбинируют, оставляя звёздочкой то, что не ограничиваем. Слэш задаёт шаг: выражение */5 в поле минут — это каждая пятая минута по сетке часа, то есть 00, 05, 10 и так до 55. Ключевая деталь, которую многие пропускают: шаг отсчитывается от начала поля, а не от момента запуска планировщика. Процесс мог подняться в 13:42, но задача с шагом в десять минут всё равно пойдёт в 13:50, а не через десять минут после старта. Сетка стабильна и одинакова у всех экземпляров сервиса — это удобно для задач, где важна синхронность: отчёты собираются по одним и тем же границам, какие бы рестарты ни случались. Минимальный шаг ограничен полем: в минутах меньше единицы не бывает, для более частой работы нужен секундный режим из отдельного урока.

Дефис превращает два числа в диапазон: 9-17 в поле часов — это с девяти утра до пяти вечера включительно. Запятая перечисляет значения: 0,15,30,45 — четыре момента каждый час. Оба приёма работают в любом поле и свободно комбинируются с шагом и звёздочкой, а в полях месяца и дня недели вместо чисел разрешены имена: JAN-DEC и MON-SUN — регистр не важен. Имена — не украшение: строка с MON-FRI читается без шпаргалки, а выражение с числом 1 в последнем поле постоянно провоцирует вопрос «понедельник или воскресенье?». Внутри диапазона и списка можно мешать имена с числами — парсер приведёт их к одному виду. Единственное правило вкуса: не собирайте в одном выражении всё сразу. Когда в строке одновременно живут шаг, диапазон, список и имена, она перестаёт читаться на ревью, и проще разбить задачу на две с двумя простыми выражениями — планировать их можно по-прежнему в одном планировщике.

Шаг можно вешать не только на звёздочку, но и на диапазон: 10-45/5 в поле минут означает 10, 15, 20 и так до 45 — включительно, потому что цикл парсера идёт до конца диапазона. Это удобно для окон: полчаса интенсивной проверки внутри часа, потом тишина. Отдельного упоминания заслуживает форма из одного числа и слэша. В robfig/cron v3 она документирована прямо в исходнике парсера: N/шаг трактуется как N-максимум/шаг, то есть 3/10 в минутах — это 3, 13, 23 и далее до 53. Не все планировщики трактуют эту форму одинаково, поэтому в переносимых конфигах надёжнее писать диапазон целиком: 3-59/10 говорит без двусмысленностей и читается одинаково у всех. Правило то же, что с ИЛИ в дневных полях: неоднозначные формы лучше не использовать не потому, что они сломаны, а потому что их смысл варьируется от системы к системе, а расписания живут дольше, чем команда, которая их писала.

Поверх пяти полей robfig/cron v3 поддерживает дескрипторы — читаемые сокращения для типовых расписаний. @yearly и его синоним @annually — раз в год, первого января в полночь; @monthly — первое число каждого месяца; @weekly — воскресенье в полночь; @daily и @midnight — каждый день в 00:00; @hourly — в начале каждого часа. Дескриптор разворачивается в обычное выражение в зоне планировщика, поэтому @daily в сервисе с московской зоной идёт в полночь по Москве — про пояса подробно в уроке про часовые пояса. Отдельно стоит @every — единственный дескриптор, который не привязан к часам вообще: после него пишется длительность в формате time.Duration, например @every 1h30m или @every 90m, и задача ходит с этим интервалом. Минимальный шаг — одна секунда, меньшие значения парсер округлит вверх. Дескрипторы не добавляют новых возможностей — то же самое пишется пятью полями, — но выражение «@daily» читается быстрее, чем пять нулей и звёздочек, а в конфигах читаемость напрямую снижает число ошибок. Внутри библиотеки каждый дескриптор собирает ту же битовую маску значений поля, что и разобранная строка: разницы в поведении и производительности нет.