Резолвер Cron: Понимание выражений Cron

Выражение cron — это строка из пяти (иногда шести) полей, разделённых пробелами, которая определяет повторяющееся расписание для автоматизированных задач. Формат был изобретён вместе с демоном cron в Unix в начале 1970-х годов и с тех пор практически не изменился. Сегодня он используется в файлах crontab Linux, в CI/CD-конвейерах вроде GitHub Actions и GitLab CI, в облачных планировщиках вроде AWS EventBridge и Google Cloud Scheduler, в оркестраторах контейнеров вроде Kubernetes CronJob, а также в фреймворках приложений вроде Spring и Quartz.

Анатомия выражения cron

Стандартный формат из пяти полей:

┌----------- минута        (0-59)
│ ┌--------- час          (0-23)
│ │ ┌------- день месяца  (1-31)
│ │ │ ┌----- месяц         (1-12)
│ │ │ │ ┌--- день недели   (0-7, воскресенье = 0 или 7)
│ │ │ │ │
* * * * *   команда для выполнения

Поля читаются слева направо: минута, час, день месяца, месяц, день недели. Выражение «0 9 * * 1-5» срабатывает в 09:00 каждый рабочий день. Каждое поле может содержать одиночное значение, список через запятую, диапазон, шаг, подстановочный знак или их комбинацию. Понимание этих операторов — и есть весь навык чтения cron.

Каждое поле имеет определённый диапазон допустимых целых значений. Значения вне допустимого диапазона приводят к ошибке или тихой неправильной настройке в зависимости от реализации cron. Понимание допустимых диапазонов каждого поля — основа чтения любого выражения cron.

Допустимые диапазоны полей

• Минута — от 0 до 59. Значение 0 — начало часа; значение 59 — минута до следующего часа.
• Час — от 0 до 23. 24-часовой формат: 0 — полночь, 12 — полдень, 23 — 11 вечера.
• День месяца — от 1 до 31. Дни нумеруются с 1. В некоторых месяцах меньше дней — в феврале 28 или 29, в апреле/июне/сентябре/ноябре — 30.
• Месяц — от 1 до 12. Январь — 1, декабрь — 12. Некоторые реализации также принимают трёхбуквенные сокращения: JAN, FEB, MAR и т. д.
• День недели — от 0 до 7. И 0, и 7 означают воскресенье. Понедельник — 1, суббота — 6. Некоторые реализации поддерживают MON, TUE, WED, THU, FRI, SAT, SUN.

Как взаимодействуют поля

Пять полей вычисляются вместе как логическое И — задача выполняется, когда все поля без подстановочных знаков совпадают одновременно. «0 9 15 * *» срабатывает ровно в 09:00 15-го числа каждого месяца. Критическое исключение: когда и день месяца, и день недели заданы без подстановочных знаков, в этом случае большинство демонов cron срабатывают, если верно ЛЮБОЕ из условий (логическое ИЛИ), а не оба. Это печально известный источник неожиданного поведения.

Мощь cron исходит от его специальных символов — операторов, превращающих фиксированные значения в гибкие шаблоны расписаний. Владение этими шестью операторами покрывает практически все шаблоны планирования, с которыми вы столкнётесь.

Шесть основных операторов

Комбинирование операторов

Операторы можно комбинировать внутри одного поля. «0,30 9-17 * * 1-5» означает «в минуты 0 и 30 каждого часа с 9 утра до 5 вечера, с понедельника по пятницу». Синтаксис шага применяется и к диапазону: «0-30/5» в поле минут означает каждые 5 минут от минуты 0 до минуты 30 (0, 5, 10, 15, 20, 25, 30). Переводчик Cron в Человеческий Язык разбирает любую комбинацию на понятный язык с объяснением каждого поля.

Большинство реальных расписаний cron укладывается в несколько повторяющихся шаблонов. Зная эти шаблоны в лицо, вы сможете читать большинство боевых crontabs без справочника.

1. "* * * * *" — Каждую минуту. Самый частый из возможных расписаний. Используется для проверок «сердцебиения» и мониторинга.
2. "*/5 * * * *" — Каждые 5 минут. Распространено для задач опроса и прогрева кэша.
3. "0 * * * *" — Каждый час ровно. Стандарт для почасовых пакетных процессов.
4. "0 0 * * *" — Ежедневно в полночь (UTC). По умолчанию для ежедневных задач очистки.
5. "0 9 * * 1-5" — 9 утра каждый рабочий день. Стандартное расписание рабочих часов.
6. "0 0 1 * *" — Полночь 1-го числа каждого месяца. Месячные запуски биллинга, генерация отчётов.
7. "0 0 1 1 *" — Полночь 1 января. Годовые задачи — продления лицензий, отчёты за год.
8. "0 0 * * 0" — Полночь каждое воскресенье. Еженедельные окна обслуживания.

Построение собственных расписаний из шаблонов

Большинство сложных расписаний — это комбинации этих шаблонов. «0 2 * * 6,0» означает «2 часа ночи в субботу и воскресенье» — окно обслуживания на выходных. «*/10 8-18 * * 1-5» означает «каждые 10 минут с 8 утра до 6 вечера, только по рабочим дням». Если вы знаете целевое расписание на понятном языке, Crontab Expression Builder позволяет настроить каждое поле визуально и генерирует правильное выражение с читаемым подтверждением и следующими пятью запусками.

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

Синтаксис cron используется далеко за пределами crontab Linux. Современные CI/CD и облачные платформы приняли тот же формат из 5 полей, но у каждой свои особенности обработки часовых поясов, поддержки макросов и ограничений минимального интервала.

Различия по платформам

Планирование cron в GitHub Actions

GitHub Actions использует стандартный синтаксис cron из 5 полей, но всегда работает в UTC. Если вам нужна задача в 9 утра по восточному времени (UTC-5), вы пишете «0 14 * * *». GitHub Actions также не поддерживает синтаксис макросов (@daily, @weekly), поэтому используйте полное выражение. Запланированные workflow в периоды высокой нагрузки могут запускаться с опозданием до 15 минут — проектируйте задачи с учётом этого сдвига.

Преобразование cron в таймеры systemd

Современные Linux-системы всё чаще используют таймеры systemd вместо классического crontab. Формат OnCalendar в systemd использует другой синтаксис, но покрывает те же шаблоны. Конвертер Cron в Таймер Systemd преобразует любое выражение cron из 5 полей в эквивалентную конфигурацию юнита таймера systemd, включая полный шаблон файлов .timer и .service.

Даже опытные разработчики сталкиваются с тихими сбоями cron. Вот самые распространённые подводные камни — каждый из них стоил продакшн-системам незамеченных простоев или дублирующихся запусков задач.

Сюрпризы часовых поясов

Cron по умолчанию работает в локальном часовом поясе сервера. Если ваш сервер в UTC, а бизнес в Нью-Йорке (UTC-5), «0 9 * * *» сработает в 4 утра по местному времени, а не в 9 утра. Облачные платформы вроде GitHub Actions и AWS EventBridge всегда работают в UTC, так что вся арифметика часовых поясов ложится на вас. Всегда подтверждайте часовой пояс перед развёртыванием расписания. Interactive Cron Scheduler позволяет симулировать запуски с учётом смещения часового пояса.

Крайние случаи конца месяца

Планирование задачи на 29, 30 или 31 число заставляет её молча пропускать месяцы, в которых такого дня нет. «0 0 31 * *» никогда не выполняется в апреле, июне, сентябре или ноябре. «0 0 29 2 *» выполняется в феврале только в високосные годы. Если вам нужно расписание «в последний день месяца», нужен более умный подход — либо запускать ежедневно со скриптом, проверяющим дату, либо использовать облачный планировщик с поддержкой синтаксиса L (последний день).

Переходы на летнее время

Переходы на летнее время могут приводить к тому, что задачи cron выполняются дважды или пропускаются. Когда часы переводят вперёд, время внутри пропущенного часа не наступает никогда. Когда часы переводят назад, время в повторяющемся часе наступает дважды. Задачи, запланированные в локальном часовом поясе в окне перехода, затрагиваются. Самая безопасная практика — запускать серверы и планировщики в UTC, где переходов на летнее время никогда не бывает.

Проблема «каждую секунду»

Стандартный cron из 5 полей имеет минимальное разрешение в одну минуту. Если вам нужно запускать задачу каждые 10 секунд, cron — не тот инструмент: используйте системный таймер, очередь задач с задержками или поле секунд, доступное в Spring Scheduler и Quartz. Попытка приблизить субминутные расписания несколькими записями crontab чревата ошибками и создаёт состояния гонки при перекрытии задач.