Обзор библиотек для работы с датами в PHP

Работа с датами в PHP: лучшие библиотеки и инструменты

Обработка дат и времени — одна из самых частых задач в веб-разработке. PHP предоставляет мощный встроенный инструментарий, но для сложных проектов часто требуются более удобные библиотеки. В этой статье мы разберем основные способы работы с датами в PHP, сравним популярные библиотеки и покажем практические примеры.

Встроенные классы PHP: DateTime и DateTimeImmutable

Начиная с версии 5.2, PHP включает в себя объектно-ориентированные классы для работы с датами. Основные из них:

DateTime — изменяемый объект даты/времени
DateTimeImmutable — неизменяемый аналог (безопаснее при передаче по ссылке)
DateInterval — представление интервала времени
DatePeriod — итерация по датам с заданным интервалом

Пример создания и форматирования даты:

<?php
$date = new DateTime('2024-12-25 10:30:00');
echo $date->format('Y-m-d H:i:s'); // 2024-12-25 10:30:00

// Добавление 1 недели
$date->modify('+1 week');
echo $date->format('Y-m-d'); // 2025-01-01
?>

Carbon — стандарт де-факто для Laravel

Carbon — это расширение для класса DateTime, которое добавляет десятки удобных методов. Библиотека активно используется в Laravel и Symfony. Установка через Composer:

composer require nesbot/carbon

Основные возможности Carbon:

Человеко-понятные модификаторы: ->addDay(), ->subMonth(), ->startOfWeek()
Локализация: Carbon::setLocale('ru')
Относительные даты: ->diffForHumans() (вернёт "3 часа назад", "через 2 дня")
Парсинг естественного языка: Carbon::parse('next monday')

Пример использования Carbon:

<?php
use Carbon\Carbon;

$now = Carbon::now('Europe/Moscow');
echo $now->toDateString(); // 2025-03-15

$birthday = Carbon::create(1990, 5, 20);
echo $birthday->age; // 34

// Разница между датами
$start = Carbon::parse('2024-01-01');
$end = Carbon::parse('2024-12-31');
echo $start->diffInDays($end); // 365

// Относительная дата
echo Carbon::parse('-1 week')->diffForHumans(); // "1 неделя назад"
?>

Chronos — альтернатива от CakePHP

Chronos — это независимая библиотека, созданная разработчиками CakePHP. Её главное отличие — неизменяемость по умолчанию (как DateTimeImmutable). Особенности:

Все объекты неизменяемы — безопаснее для многопоточных сред
Поддержка часовых поясов с учётом летнего времени
Удобные методы округления: ->startOfDay(), ->endOfMonth()
Лёгкий вес (нет зависимостей)

Пример работы с Chronos:

<?php
use Cake\Chronos\Chronos;

$date = Chronos::now();
echo $date->addDays(10)->format('d.m.Y'); // 25.03.2025

// Разница с указанием точности
$future = Chronos::create(2025, 12, 31);
echo $date->diffInDays($future); // 291

// Проверка даты
echo $date->isWeekend() ? 'Выходной' : 'Будний день';
?>

CakePHP Time — для работы с временными зонами

Ещё один инструмент от CakePHP — Cake\I18n\Time. Он расширяет Chronos и добавляет поддержку интернационализации. Полезен, когда нужно выводить даты на разных языках:

<?php
use Cake\I18n\Time;

Time::setDefaultLocale('ru_RU');
$time = Time::parse('2025-03-15 14:30:00', 'Europe/Moscow');
echo $time->i18nFormat('dd MMMM yyyy'); // 15 марта 2025
?>