Когда запись в календаре правильная, а письмо сдвинуто на несколько часов, виноват обычно не 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 процессов.

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