Если пользователь выбрал 09:00, хранить только строку «09:00» или постоянное смещение +03:00 недостаточно. Планировщику нужны дата, локальное время и идентификатор зоны вроде Europe/Moscow. Из них строится конкретный UTC-момент запуска; очередь работает уже с ним.

Сначала не меняйте расписание всем получателям. Возьмите одно ночное сообщение и выпишите пять времён: что выбрал пользователь, какая зона сохранена, какой UTC рассчитан, когда задача попала в очередь и когда провайдер подтвердил отправку. Отклонение появляется ровно на одном переходе.

Три вида времени нельзя складывать в одно поле

ЗначениеПримерДля чего нужно
Локальное правилоКаждый рабочий день в 09:00Намерение пользователя
IANA zoneEurope/BerlinПравила смещений и DST
UTC instant2026-10-05T07:00:00ZОднократная задача в очереди
Enqueued atВремя постановкиДиагностика планировщика
Delivered atВремя ответа провайдераДиагностика доставки

Смещение — свойство конкретной даты в зоне, а не настройка пользователя навсегда. База IANA периодически обновляется, потому что государства меняют границы зон и правила переходов. Запись Europe/Berlin позволяет библиотеке выбрать верное смещение для нужной даты; аббревиатура CET или число +01:00 этой истории не содержит.

Следующий запуск строится в локальной зоне

from datetime import date, datetime, time, timezone
from zoneinfo import ZoneInfo

def to_utc(run_day: date, local_hhmm: time, zone_id: str) -> datetime:
    zone = ZoneInfo(zone_id)
    local_dt = datetime.combine(run_day, local_hhmm, tzinfo=zone)
    return local_dt.astimezone(timezone.utc)

scheduled_utc = to_utc(date(2026, 10, 5), time(9, 0), "Europe/Berlin")

Такой расчёт выполняют для каждой даты повторения. Нельзя один раз перевести 09:00 в UTC и затем прибавлять ровно 24 часа месяцами: после смены смещения локальная отправка съедет. Для несуществующего или повторяющегося времени во время перехода DST заранее задайте продуктовую политику: перенести вперёд, пропустить либо выбрать первое или второе вхождение.

Источник зоны должен быть один и объяснимый

Зона может находиться в профиле пользователя, настройке рабочего пространства или самой автоматизации. Установите приоритет явно, например: zone задачи → zone пользователя → zone организации. Зона сервера применяется только как аварийный запрет с ошибкой, а не как незаметный default.

  • Браузерная зона подходит для подсказки, но пользователь должен увидеть и подтвердить её.
  • Изменение зоны профиля не обязано задним числом менять юридически значимые разовые события.
  • Организационная рассылка может следовать зоне офиса, даже если сотрудник путешествует.
  • Для каждого расписания храните zone_source, чтобы объяснить выбор.
  • Аббревиатуры MSK, CST и IST не используйте как идентификаторы.

Ночной факт может возникнуть после планировщика

Если scheduled_utc верен, сравните enqueued_at и delivered_at. Большой разрыв до enqueue указывает на зависший scheduler или неверную выборку due-задач. Разрыв после enqueue — на очередь, повторные попытки, rate limit или задержку провайдера. Исправление time zone не лечит перегруженного worker.

У повторной попытки сохраняют исходный notification_id и intended_at. Не создавайте новый бизнес-экземпляр на каждый retry: иначе пользователь получит ночной дубль, а журнал покажет два независимых сообщения вместо одной задержанной доставки.

Переходы DST входят в обязательные тесты

  1. Обычный зимний день в зоне с DST.
  2. Обычный летний день в той же зоне.
  3. Дата перед переводом часов и дата после него.
  4. Несуществующее локальное время во время скачка вперёд.
  5. Повторяющееся время при переводе назад.
  6. Пользователь сменил зону после создания следующей задачи.

Критерий успеха формулируется в локальном времени: уведомление остаётся в 09:00 выбранной зоны. Для одноразовой встречи критерий может быть другим — неизменный UTC instant. Эти сценарии нельзя обслуживать одним алгоритмом без поля, которое описывает намерение.

Миграция не должна разбудить пользователей

Перед исправлением остановите создание следующего окна, но не удаляйте уже отправленные записи. Пересчитайте будущие задачи в режиме preview, сравните старый и новый UTC и отдельно выделите те, что сдвигаются через границу тихих часов. После проверки заменяйте задания транзакционно или по version поля расписания.

Лог показывает цепочку, а не личные данные

Для разбора подготовьте schedule_id, zone_id, zone_source, requested_local, calculated_utc, scheduler version и три технические отметки времени. Текст сообщения, список получателей и access token не нужны. С такой трассой ошибка воспроизводится на тестовой зоне и дате без отправки реального уведомления.

Проверенные источники