PHPTime

Часовые пояса в PHP: как хранить и преобразовывать время

Храните моменты событий в UTC, а для отображения переводите их в часовой пояс пользователя. Если пользователь назначает встречу на 09:00 по местному времени, сохраните также местное время и идентификатор зоны: они определяют, когда встреча должна состояться.

Сначала определите, что означает дата

Время платежа, день рождения и начало рабочего дня могут выглядеть похоже в форме, но требуют разных моделей хранения. Начните с вопроса: должно ли значение обозначать один и тот же момент для людей в разных странах?

Что хранитсяПримерПредставление
Момент событияПлатёж принятДата и время в UTC
Календарная датаДень рожденияDATE без времени суток
Местное расписаниеПриём по понедельникам в 09:00 в БерлинеПравило повтора, местное время и зона Europe/Berlin

UTC — единая шкала времени. Смещение +02:00 показывает разницу с UTC в конкретный момент. Идентификатор IANA, например Europe/Berlin, задаёт правила, по которым эта разница меняется. В Берлине 09:00 соответствует 08:00 UTC зимой и 07:00 UTC летом. Если встреча должна состояться в 09:00 по Берлину независимо от будущих изменений правил, местное время и зону нужно сохранить даже тогда, когда момент в UTC уже рассчитан для очереди уведомлений.

Настройте UTC по умолчанию и передавайте зону явно

Для PHP 8.3–8.5 задайте date.timezone = UTC в конфигурации. Если конфигурация недоступна, вызовите date_default_timezone_set('UTC') при запуске приложения. Проверьте настройки веб-процессов, CLI и обработчиков очередей: у них могут быть разные файлы конфигурации. В коде преобразования передавайте зоны явно, чтобы результат не зависел от среды запуска.

Используйте DateTimeImmutable. Метод setTimezone() возвращает новый объект с тем же моментом, поэтому исходное значение можно продолжать использовать для записи и сравнения.

PHP
<?php
declare(strict_types=1);

$utc = new DateTimeZone('UTC');
$viewerZone = new DateTimeZone('Asia/Bangkok');
$paidAt = new DateTimeImmutable('now', $utc);

// Одна дата для записи, другая — для отображения того же момента.
$databaseValue = $paidAt->format('Y-m-d H:i:s.u');
$displayValue = $paidAt->setTimezone($viewerZone)->format('d.m.Y H:i');

Функция time() возвращает Unix timestamp в секундах. На число не влияет часовой пояс PHP. Если вычесть из него смещение зоны, изменится сам момент. Для пользовательского вывода передайте timestamp или объект даты в форматтер с нужной зоной. Если нужны названия месяцев и привычный для пользователя порядок полей, используйте IntlDateFormatter из расширения intl с явными локалью и зоной.

Согласуйте PHP и MySQL

Установите SET SESSION time_zone = '+00:00' при инициализации каждого соединения с MySQL. Это настройка SQL-сессии, независимая от конфигурации PHP. Она влияет на NOW(), преобразования для TIMESTAMP и значения, которые сервер выставляет через DEFAULT CURRENT_TIMESTAMP. При повторном использовании соединений проследите, чтобы код получал сессию с ожидаемой зоной.

  • DATETIME(6) хранит введённую дату и время с точностью до микросекунд. Для поля с моментом договоритесь, что все записи идут в UTC. При чтении явно укажите UTC, поскольку строка из столбца не содержит смещения.
  • TIMESTAMP(6) при записи преобразуется из зоны SQL-сессии в UTC, а при чтении преобразуется обратно. Учитывайте ограничение диапазона около 2038 года, если поле может содержать далёкие будущие даты.
PHP
<?php
declare(strict_types=1);

function savePaymentTime(PDO $pdo, int $id, DateTimeImmutable $paidAt): void
{
    // Выполните настройку при получении соединения. Здесь она показана рядом с записью.
    $pdo->exec("SET SESSION time_zone = '+00:00'");
    $utcValue = $paidAt->setTimezone(new DateTimeZone('UTC'));
    $query = $pdo->prepare('UPDATE payments SET paid_at = :paid_at WHERE id = :id');
    $query->execute(['paid_at' => $utcValue->format('Y-m-d H:i:s.u'), 'id' => $id]);
}

Для paid_at из примера используйте DATETIME(6) или TIMESTAMP(6) с UTC в сессии. Прочитанную непустую строку разбирайте как new DateTimeImmutable($value, new DateTimeZone('UTC')). Согласуйте точность столбца с API: при сериализации через DATE_ATOM дробная часть секунды пропадёт. Для передачи микросекунд подходит формат Y-m-d\TH:i:s.uP.

Разбирайте входные даты по контракту

Для API, принимающего момент, потребуйте дату и время со смещением, например 2026-07-01T14:30:00+02:00 или 2026-07-01T12:30:00Z. Сначала проверьте форму и календарную корректность, затем приведите значение к UTC. Если входная строка уже содержит смещение, аргумент зоны конструктора DateTimeImmutable его не переопределит.

Для полей местного времени принимайте отдельно строку даты и времени и идентификатор зоны. Для пользовательских настроек берите идентификаторы из DateTimeZone::listIdentifiers(). Проверяйте точное совпадение с форматом после разбора: PHP может нормализовать неверную дату или сдвинуть время, которое попало в пропущенный час.

PHP
<?php
declare(strict_types=1);

function parseLocalMinute(string $input, DateTimeZone $zone): DateTimeImmutable
{
    $format = 'Y-m-d H:i';
    $date = DateTimeImmutable::createFromFormat('!' . $format, $input, $zone);
    $errors = DateTimeImmutable::getLastErrors();

    // В PHP 8.3–8.5 при чистом разборе getLastErrors() возвращает false.
    if ($date === false || $errors !== false || $date->format($format) !== $input) {
        throw new InvalidArgumentException('Укажите существующее местное время.');
    }

    return $date;
}

Префикс ! сбрасывает компоненты, которых нет во входном формате. В примере секунды будут нулевыми. Для встречи, попавшей в повторяющийся час, нужна дополнительная проверка: оба возможных момента имеют одну и ту же строку местного времени.

Обработайте пропущенный и повторяющийся час

При переводе часов вперёд часть местных значений исчезает. В Берлине 29 марта 2026 года 02:30 пропускается. При переводе часов назад 25 октября 2026 года 02:30 встречается дважды: сначала с +02:00, затем с +01:00. Для бронирования первый случай можно отклонить с просьбой выбрать другое время. Во втором покажите оба варианта со смещениями или примените явно заданное правило выбора.

Для реализации возьмите смещения вокруг даты из DateTimeZone::getTransitions() для именованной зоны. Для каждого отличающегося смещения рассчитайте возможный момент и переведите его обратно в ту же зону. Оставьте только моменты, у которых совпали введённые местные дата и время. Ноль совпадений означает пропуск, два — повтор. Если клиент передаёт и зону, и смещение, проверьте, что выбранный момент при обратном переводе даёт оба исходных значения.

Учитывайте смысл арифметики. Для задачи «через 24 часа» прибавьте new DateInterval('PT24H') к моменту в UTC. Для задачи «завтра в 09:00» сначала определите следующую календарную дату в зоне расписания и заново разрешите местное время. Между двумя местными 09:00 на соседних датах при часовом переводе может пройти 23 или 25 часов.

Фильтруйте события по местному дню через границы UTC

Для отчёта «платежи за 25 октября по Берлину» рассчитайте начало выбранного дня и начало следующего календарного дня в Europe/Berlin. Переведите обе границы в UTC и передайте их параметрами запроса. Верхняя граница исключается: так в выборку войдут все доли последней секунды. Если продукт поддерживает зоны, где переход затрагивает полночь, границу дня определяйте по первому существующему моменту этой местной даты.

SQL
SELECT id, paid_at
FROM payments
WHERE paid_at >= :from_utc
  AND paid_at < :to_utc;

Такое условие позволяет MySQL использовать обычный индекс по paid_at для поиска по диапазону. Преобразование границ выполняется один раз на запрос. Для нескольких часовых поясов рассчитывайте границы отдельно по правилам каждой зоны.

Переносите старые данные с учётом их происхождения

Перед миграцией выясните, что реально записывалось в каждое поле: локальный DATETIME, строка UTC, TIMESTAMP с преобразованием в SQL-сессии или просто календарная дата. Проверьте настройки старых процессов и сопоставьте несколько записей с независимыми отметками времени, например с журналом платежей. У одного столбца могут быть разные правила до и после переезда сервера.

Для подтверждённых локальных значений подходит CONVERT_TZ(old_value, 'Europe/Berlin', '+00:00'). Для именованных зон в MySQL должны быть загружены таблицы часовых поясов. Проверьте результат на зимних и летних датах, а также рядом с переходами. Повторяющийся час без дополнительного смещения или независимой метки нельзя однозначно восстановить. Такие строки отложите до сверки по журналам.

Записывайте результат в отдельное поле партиями, сохраняя исходное значение до сверки. Сравните количество обработанных строк, проверьте расхождения и только потом переключайте чтение. Для TIMESTAMP сначала прочитайте колонку через сессию UTC и проверьте, какие моменты уже сохранены: повторная конвертация способна сдвинуть корректные записи.

Чек-лист перед выпуском

  • Для каждого поля определены смысл, часовой пояс и точность. Моменты хранятся в UTC, календарные даты — в DATE, местные расписания — с зоной IANA.
  • Веб-приложение, CLI и воркеры используют одинаковые настройки PHP. Сессии MySQL инициализируются в UTC.
  • API требует смещение для моментов. При вводе местного времени учтены обе ситуации на переходе часов.
  • Отчёты используют полуоткрытые диапазоны UTC, рассчитанные из местных календарных границ.
  • Проверены запись и чтение с нужной точностью, смена зоны при выводе и расписания вблизи переходов. Данные часовых поясов обновляются в средах, где рассчитываются будущие события.

Частые вопросы

Нужно ли хранить часовой пояс для каждой записи?

Для времени платежа или записи в журнале достаточно момента в UTC. Храните зону отдельно, если от неё зависит смысл записи, например при бронировании по местному времени или повторе по календарю.

Почему после setTimezone() меняется время на экране, а Unix timestamp остаётся прежним?

Метод показывает прежний момент по часам другой зоны. Например, 12:00 UTC и 19:00 в Бангкоке соответствуют одному Unix timestamp.

Можно ли хранить часовой пояс пользователя в виде смещения +03:00?

Да, если пользователь явно выбрал постоянное смещение. Для времени по правилам города храните идентификатор IANA. Он учитывает сезонные и исторические изменения смещения.

Справка по теме

Ещё в разделе «Производительность»

Как быстрее обойти массив в PHP без ключей

Как быстро обойти значения массива в PHP 8.3–8.5: когда выбрать foreach, где нужен индекс и как измерить скорость циклов без влияния вывода.

8 мин

Как быстрее обойти массив без ключей в PHP

Как обойти массив без ключей в PHP 8.3–8.5. Сравниваем foreach, array_walk, iterator_apply и for, разбираем остановку обхода и замеряем скорость без вывода.

8 мин

Микрооптимизация в PHP 8.3–8.5: что ускоряет код на практике

Что влияет на скорость PHP 8.3–8.5: разбираем foreach и for, кавычки, echo и print, строковые функции и SQL. Как найти узкое место и измерить эффект.

7 мин

Почему Nginx + PHP-FPM может быть быстрее Apache + mod_php

Разбираем, когда Nginx и PHP-FPM быстрее Apache с mod_php, как на результат влияют MPM, .htaccess и OPcache и как измерить разницу на своём проекте.

6 мин