Дата и время в PHP: date, DateTime и часовые пояса
Функции time() и date() подходят, когда нужно получить Unix timestamp или вывести текущую дату. Для разбора пользовательского ввода, работы с часовыми поясами и календарных расчётов удобнее DateTimeImmutable. Разберём эти задачи на примерах для PHP 8.3–8.5.
Текущая дата и время в PHP: date() и time()
time() возвращает целое число секунд с начала эпохи Unix — 1 января 1970 года, 00:00:00 UTC. date() возвращает строку в заданном формате. Если передать ей только формат, она возьмёт текущий момент. Часовой пояс для вывода определяется настройкой PHP.
<?php
declare(strict_types=1);
date_default_timezone_set('Europe/Moscow');
$timestamp = time(); // Сохраняем один момент для всех строк.
echo date('d.m.Y', $timestamp), PHP_EOL; // Текущая дата.
echo date('H:i:s', $timestamp), PHP_EOL; // Текущее время.
echo gmdate('Y-m-d H:i:s', $timestamp), ' UTC', PHP_EOL;Один вызов time() полезен, когда дата и время выводятся отдельно. Два вызова date() без общего timestamp могут попасть по разные стороны полуночи. В приложении часовой пояс по умолчанию обычно задают один раз при запуске или через директиву date.timezone в php.ini.
Формат даты в PHP: символы date() и format()
date() и метод DateTimeInterface::format() используют одинаковые обозначения. Например, Y-m-d даёт 2026-11-19, а d.m.Y H:i — 19.11.2026 09:05. Регистр букв важен.
| Символ | Что выводит | Пример |
|---|---|---|
Y | Год из четырёх цифр для обычных календарных дат | 2026 |
m, d | Месяц и день с ведущим нулём | 11, 09 |
H, i, s | Часы в 24-часовом формате, минуты и секунды | 09, 05, 07 |
v, u | Миллисекунды и микросекунды объекта даты | 123, 123456 |
P, e | Смещение относительно UTC и идентификатор часового пояса | +03:00, Europe/Moscow |
c | Дата и время ISO 8601 со смещением | 2026-11-19T09:05:07+03:00 |
Частая опечатка — H:m:s. Символ m подставит номер месяца, поэтому для минут нужен i. Чтобы вывести букву буквально, поставьте перед ней обратную косую черту. Для номера ISO-недели используйте o-\WW. Символ o выводит год ISO-недели, который на границе декабря и января может отличаться от календарного Y.
Для обмена датой и временем с API можно использовать $date->format(DATE_ATOM). Если контракт требует миллисекунды, подойдёт Y-m-d\TH:i:s.vP. При форматировании целого timestamp через date() дробная часть секунды будет нулевой. Для русских названий месяцев используйте IntlDateFormatter из расширения intl. Например, шаблон ICU d MMMM yyyy с локалью ru_RU даст «19 ноября 2026». У ICU собственные обозначения формата.
Unix timestamp в PHP: секунды, миллисекунды и замеры
Unix timestamp обозначает один момент независимо от часового пояса. Например, 0 — начало эпохи Unix, а -1 — секунда до неё. getTimestamp() возвращает секунды из объекта даты. JavaScript Date.now() возвращает миллисекунды, поэтому перед передачей числа между системами согласуйте единицы.
<?php
declare(strict_types=1);
$milliseconds = 1_766_000_000_123; // Пример входного значения на 64-битном PHP.
$seconds = intdiv($milliseconds, 1000); // Для положительного числа отбрасываем доли секунды.
echo gmdate(DATE_ATOM, $seconds), PHP_EOL;Если важны миллисекунды, сохраняйте их до конца обработки. intdiv() округляет к нулю. Для отрицательных значений, когда нужна целая секунда с округлением вниз, при ненулевом остатке уменьшите результат на единицу. На 32-битных сборках диапазон int ограничивает целочисленные Unix timestamp примерно 1901–2038 годами. На таких сборках для хранения широкого диапазона дат удобнее строковое представление.
Для замера длительности операции используйте разность двух показаний hrtime(true) и делите её на 1_000_000, чтобы получить миллисекунды. hrtime() использует монотонные часы. Для отметки времени события с дробной частью можно взять microtime(true) или создать DateTimeImmutable и отформатировать его с v или u.
strtotime() в PHP: разбор свободной формы
strtotime() разбирает строки вроде 2026-11-19 09:00:00, +2 days и next Monday. Относительное выражение вычисляется от второго аргумента, а при его отсутствии — от текущего времени. Если во входной строке нет часового пояса, применяется пояс PHP по умолчанию.
<?php
declare(strict_types=1);
date_default_timezone_set('UTC');
$base = (new DateTimeImmutable('2026-11-19 09:00:00'))->getTimestamp();
$timestamp = strtotime('+2 days', $base);
if ($timestamp === false) {
throw new InvalidArgumentException('Не удалось разобрать дату');
}
echo date('Y-m-d H:i:s', $timestamp), PHP_EOL; // 2026-11-21 09:00:00Сравнивайте результат с false строго. Значение 0 — корректная отметка времени, которую условие if (!$timestamp) посчитает ошибкой. Относительные выражения парсер ожидает на английском. Для поля формы с заданным форматом используйте createFromFormat(). Гибкий парсер может нормализовать несуществующий день, а запись вроде 03/04/2026 легко прочитать по-разному.
DateTime и DateTimeImmutable: создание и проверка даты
DateTime меняет объект при вызове modify(), add() и setTimezone(). Если две переменные ссылаются на этот объект, обе увидят изменение. DateTimeImmutable возвращает новый объект, поэтому результат вызова нужно присвоить. Когда код только читает дату, в параметре можно указать DateTimeInterface, чтобы принимать оба типа.
Для ввода ДД.ММ.ГГГГ задайте формат явно. Символ ! сбрасывает незаданные поля, поэтому время в примере будет 00:00:00. Проверка предупреждений отсекает даты вроде 31.02.2026, которые парсер способен перенести на март. Сравнение с исходной строкой дополнительно требует точного совпадения с форматом, включая ведущие нули.
<?php
declare(strict_types=1);
function parseDate(string $input, DateTimeZone $zone): DateTimeImmutable
{
if (str_contains($input, "\0")) {
throw new InvalidArgumentException('Дата содержит нулевой байт');
}
$date = DateTimeImmutable::createFromFormat('!d.m.Y', $input, $zone);
$errors = DateTimeImmutable::getLastErrors(); // Читаем сразу после разбора.
if ($date === false || $errors !== false || $date->format('d.m.Y') !== $input) {
throw new InvalidArgumentException('Укажите дату в формате ДД.ММ.ГГГГ');
}
return $date;
}
echo parseDate('19.11.2026', new DateTimeZone('Europe/Moscow'))
->format(DATE_ATOM), PHP_EOL; // 2026-11-19T00:00:00+03:00В PHP 8.3–8.5 getLastErrors() возвращает false, если разбор прошёл без ошибок и предупреждений. Если предметная область ограничивает допустимые даты, например дата рождения должна быть в прошлом, проверяйте это после успешного разбора.
Часовые пояса в PHP: DateTimeZone, UTC и локальное время
Идентификатор Europe/Berlin учитывает правила региона, включая переходы на летнее время. Смещение +01:00 фиксировано. Используйте региональный идентификатор, если надо назначить встречу по местному времени или показать историю событий с действовавшими тогда смещениями. DateTimeZone::listIdentifiers() пригодится для списка в настройках пользователя.
<?php
declare(strict_types=1);
$utc = new DateTimeImmutable('2026-11-19 06:00:00', new DateTimeZone('UTC'));
$local = $utc->setTimezone(new DateTimeZone('Asia/Bangkok'));
echo $local->format('d.m.Y H:i P'), PHP_EOL; // 19.11.2026 13:00 +07:00setTimezone() меняет локальное представление, сохраняя момент. Если строка конструктора уже содержит Z, смещение или идентификатор пояса, PHP использует их и игнорирует пояс, переданный вторым аргументом. Для абсолютных событий обычно достаточно хранить UTC. Для повтора «каждый понедельник в 09:00 по Берлину» храните локальное расписание и идентификатор региона. Дату рождения или срок «до 19 ноября включительно» удобно хранить как календарную дату, если по смыслу время не задано.
Календарные расчёты и отличия PHP 8.3–8.5
«Завтра в то же местное время» и «через 24 часа» могут дать разные результаты. При весеннем переводе часов местные сутки иногда длятся 23 часа. При осеннем переводе отдельное местное время может встретиться дважды. Для однозначного ввода в такой час запрашивайте смещение или используйте явно заданное правило выбора.
<?php
declare(strict_types=1);
$start = new DateTimeImmutable('2026-03-28 12:00:00', new DateTimeZone('Europe/Berlin'));
$tomorrow = $start->add(new DateInterval('P1D')); // Один календарный день.
$in24Hours = $start->add(new DateInterval('PT24H')); // 24 часа.
echo $tomorrow->format('Y-m-d H:i P'), PHP_EOL; // 2026-03-29 12:00 +02:00
echo $in24Hours->format('Y-m-d H:i P'), PHP_EOL; // 2026-03-29 13:00 +02:00Прибавление месяца тоже требует правила. Например, 2026-01-31 плюс P1M даёт 2026-03-03 из-за переноса лишних дней. Если расчётный срок должен приходиться на последнее число следующего месяца, используйте modify('last day of next month').
- Начиная с PHP 8.3, конструкторы
DateTimeиDateTimeImmutableпри некорректной строке выбрасываютDateMalformedStringException. Методыmodify()в объектном стиле также выбрасывают это исключение при некорректном выражении. Процедурнаяdate_modify()сохраняет возвратfalseс предупреждением. - В PHP 8.4 появились
DateTime::createFromTimestamp()иDateTimeImmutable::createFromTimestamp(). Они принимаютint|floatи создают объект в UTC. Для совместимости с 8.3 можно использоватьsetTimestamp()для целых секунд. Метод сохраняет пояс исходного объекта. - В PHP 8.5 у
gettimeofday()устарел параметр$as_float. Для дробной отметки времени используйтеmicrotime(true).
Чек-лист для работы с датой и временем
- Берите
time()для Unix timestamp в секундах иdate()для простого вывода в часовом поясе приложения. - Используйте
DateTimeImmutableдля расчётов и сохраняйте результат каждого преобразования. - Разбирайте поля формы через
createFromFormat(). Проверяйте возврат, предупреждения и совпадение с ожидаемым форматом. - Согласуйте единицы Unix timestamp с клиентом и явно передавайте смещение в строках для API.
- Проверьте расчёты на полуночи, 29 февраля, конце месяца и переводе часов, если эти случаи влияют на результат.
Частые вопросы
Как получить текущую дату и время в PHP одной строкой?
Вызовите date('d.m.Y H:i:s'). Для вывода в часовом поясе пользователя создайте DateTimeImmutable с аргументом 'now' и нужным DateTimeZone, затем вызовите format('d.m.Y H:i:s').
Чем отличаются time(), strtotime() и date()?
time() возвращает текущий Unix timestamp в секундах. strtotime() разбирает строку и возвращает timestamp или false. date() форматирует timestamp в строку.
Как перевести дату из UTC в часовой пояс пользователя?
Создайте DateTimeImmutable в UTC, вызовите setTimezone() с нужным DateTimeZone и сохраните возвращённый объект. Вызов format() на этом объекте покажет местное время.