DateTime в PHP: создание объектов даты и времени

Расширенные примеры создания объектов даты

Создание из Unix timestamp

Если у вас уже есть метка времени Unix, используйте конструктор с префиксом @:

<?php
$ts = new DateTime('@1743033600'); // 2025-03-27 00:00:00 UTC
echo $ts->format('Y-m-d H:i:s T'); // 2025-03-27 00:00:00 UTC
?>

Внимание: часовой пояс для таких объектов всегда UTC. Для смены зоны примените setTimezone().

Создание с микросекундами

Конструктор не принимает микросекунды из обычной строки. Используйте createFromFormat с форматом 'U.u' и передачей микротайма:

<?php
$micro = DateTime::createFromFormat('U.u', sprintf('%.6f', microtime(true)));
echo $micro->format('Y-m-d H:i:s.u'); // 2025-02-28 15:30:45.123456
?>

Создание на основе относительных дат

Строки типа 'next Monday', 'last day of March 2025' или '+1 week' поддерживаются конструктором (и modify):

<?php
$nextMon = new DateTime('next Monday');
echo $nextMon->format('Y-m-d l'); // например, 2025-03-03 Monday

$lastDayMarch = new DateTime('last day of March 2025');
echo $lastDayMarch->format('Y-m-d'); // 2025-03-31

$inTwoWeeks = new DateTime('+2 weeks');
echo $inTwoWeeks->format('Y-m-d');
?>

Эти конструкции полезны для периодических расчётов. Однако они опираются на парсер PHP, который может дать неожиданный результат для сложных фраз. Тестируйте.

Создание последовательности дат (DatePeriod)

Класс DatePeriod не создаёт отдельный объект даты, но генерирует набор объектов DateTime (или DateTimeImmutable) с заданным интервалом. Пример: все дни марта 2025 года.

<?php
$start = new DateTime('2025-03-01');
$end   = new DateTime('2025-04-01');
$interval = new DateInterval('P1D');
$period = new DatePeriod($start, $interval, $end);

foreach ($period as $day) {
    echo $day->format('Y-m-d l') . "\n";
}
?>

2025-03-01 Saturday
2025-03-02 Sunday
...
2025-03-31 Monday

DatePeriod принимает объекты DateTimeInterface, что позволяет использовать как изменяемые, так и неизменяемые версии.

Создание копии объекта даты

Иногда требуется скопировать существующий объект, не ссылаясь на исходный. Для DateTimeImmutable это автоматически. Для DateTime используйте clone или createFromInterface (PHP 8.0+):

<?php
$original = new DateTime('2025-03-15');
$copy = clone $original;
$copy->modify('+1 day');
echo $original->format('Y-m-d'); // 2025-03-15
echo $copy->format('Y-m-d');    // 2025-03-16

// Альтернатива (PHP 8.0+)
$copy2 = DateTime::createFromInterface($original);
?>

Создание объекта даты из строки с временной зоной в формате ISO 8601

DateTime корректно разбирает строки, содержащие смещение или название зоны:

<?php
$iso = new DateTime('2025-03-15T12:00:00+05:00');
echo $iso->format('c e'); // 2025-03-15T12:00:00+05:00 +05:00

$withZone = new DateTime('2025-03-15 12:00:00 America/New_York');
echo $withZone->format('c e'); // 2025-03-15T12:00:00-04:00 America/New_York
?>

Создание объекта даты с помощью фабричного метода (расширенный приём)

Вы можете написать свою фабрику для создания дат в определённом контексте. Например, для единообразной работы с UTC-временем:

<?php
function createUtcDate($string): DateTimeImmutable {
    return new DateTimeImmutable($string, new DateTimeZone('UTC'));
}

$d = createUtcDate('2025-03-15 12:00:00');
echo $d->format('c e'); // 2025-03-15T12:00:00+00:00 UTC
?>