Планирование Cron с учетом часового пояса без пропущенных заданий

Безопасное cron-планирование с учётом часовых поясов

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

Классическая ловушка

Вам нужен ежедневный отчёт в 9:00 по Москве. Вы пишете:

0 9 * * *

Но сервер работает в UTC. Это сработает в 9:00 UTC = 12:00 MSK. Отчёт приходит в обед вместо утра.

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

Переход на летнее/зимнее время создаёт два конкретных сбоя:

Перевод вперёд (2:00 → 3:00): задание на 0 2 * * * не выполняется в эту ночь. Часа 2:00 просто не существует.

Перевод назад (2:00 → 1:00): задание на 0 1 * * * выполняется дважды. Час 1:00 случается два раза.

Это затрагивает США, ЕС и ~70 других стран. В России с 2014 года постоянное время (MSK = UTC+3), но если ваши серверы или пользователи в Европе/США -- проблема актуальна.

Решения

1. Храните и запускайте в UTC

Самое простое решение: задавайте все cron-выражения в UTC и конвертируйте для отображения.

# 9:00 MSK = 6:00 UTC
0 6 * * *

2. Используйте CRON_TZ (поддерживается systemd, Kubernetes, многими планировщиками)

# systemd timer
CRON_TZ=Europe/Moscow
0 9 * * *

# Kubernetes CronJob
apiVersion: batch/v1
kind: CronJob
metadata:
  name: daily-report
spec:
  schedule: "CRON_TZ=Europe/Moscow 0 9 * * *"
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: report
            image: report-runner:latest

3. Используйте IANA-имена часовых поясов, не смещения

# ХОРОШО
CRON_TZ=Europe/Moscow
CRON_TZ=America/New_York

# ПЛОХО -- не учитывает DST
CRON_TZ=EST         # всегда -5, игнорирует EDT
CRON_TZ=UTC-5       # та же проблема

4. Избегайте окна 1:00-3:00 ночи

Если не можете использовать CRON_TZ, планируйте задания вне окна перехода DST (1:00-3:00 по локальному времени). Задания в 4:00 и позже -- безопасны.

Проверяйте перед деплоем

Вставьте cron-выражение в Cron Validator, чтобы увидеть следующие 5-10 запусков и убедиться, что они соответствуют ожиданиям. Проверьте даты и в январе (стандартное время), и в июле (летнее время).

Связанные материалы