Когда запись в календаре правильная, а письмо сдвинуто на несколько часов, виноват обычно не SMTP. Ошибка появляется раньше: локальное время превратили в UTC дважды, потеряли временную зону в очереди или отформатировали дату в зоне сервера.
Для одного теста запишите пять значений: что выбрал клиент, какая зона была у услуги, что ушло в API, что лежит в базе и какую строку получил шаблон. Рядом с каждым временем обязательно укажите offset или IANA zone. Строка `2026-10-05 15:00` без зоны не годится для расследования.
Момент, местное время и зона — не одно и то же
Момент можно хранить как UTC instant. Но для будущей записи полезно помнить и бизнес-зону, например `Europe/Moscow`: именно по её правилам нужно показывать 15:00 клиенту и сотруднику. Фиксированный offset `+03:00` не является названием зоны и не содержит исторических правил.
Если услуга привязана к месту, её время обычно определяется зоной места оказания услуги, а не зоной сервера и не случайной зоной браузера.
Где именно возникает типичный сдвиг
| Этап | Опасный признак | Нормальный контракт |
|---|---|---|
| Форма | Передаётся строка без зоны | Локальная дата + business timezone или готовый instant |
| API | Парсер угадывает системную зону | ISO 8601 с offset и отдельный zone ID при необходимости |
| Очередь | Сериализуется объект Date в разном формате | Однозначный UTC timestamp |
| Шаблон | Форматирование в timezone процесса | Явно переданная зона получателя или услуги |
Особенно внимательно проверяйте код, который сначала парсит строку как local time, потом вызывает преобразование в UTC, хотя библиотека уже сделала это при разборе offset. Такой двойной перевод и даёт стабильный сдвиг.
Минимальный журнал для одного подтверждения
booking_id=BK-1042
selected_local=2026-10-05T15:00:00
business_zone=Europe/Moscow
stored_instant=2026-10-05T12:00:00Z
message_zone=Europe/Moscow
rendered=5 октября, 15:00 МСКВ production не нужно логировать имя, телефон и текст письма. Идентификатора записи, технических времён, шаблона и локали достаточно, чтобы увидеть расхождение.
Тесты, которые стоит добавить до исправления
- Клиент и услуга находятся в одной зоне.
- Клиент путешествует, но запись относится к зоне салона или офиса.
- Уведомление формируется фоновым worker в UTC.
- Дата попадает рядом с переходом на летнее или зимнее время в зоне, где он существует.
- Повторная отправка старого сообщения использует сохранённую бизнес-зону, а не текущую зону сервера.
Как выпускать исправление
Сначала измените контракт и форматирование новых подтверждений. Исторические записи не пересчитывайте массово, пока не известно, хранилась ли в базе местная дата или уже UTC instant. Для старых данных нужен отдельный dry-run с исходной зоной и ожидаемым отображением.
После релиза сравните письмо, SMS, личный кабинет и календарный файл для одной записи. Все каналы должны показывать один момент, а там, где возможна неоднозначность, — ещё и понятную зону. Для внешнего разбора подготовьте обезличенный payload и настройки timezone процессов.