Работа с датами в PHP: библиотеки для даты и времени |…

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

Работа с датами и временем — одна из ключевых задач в веб-разработке. В PHP есть встроенный класс DateTime, но для сложных операций (часовые пояса, интервалы, форматирование, локализация) часто используют специализированные библиотеки. В этой статье рассмотрим три популярных инструмента: Carbon, Chronos и улучшенный DateTime, с примерами кода и рекомендациями.

1. Встроенный класс DateTime

PHP предоставляет базовый функционал через классы DateTime, DateTimeImmutable, DateInterval и DatePeriod. Этого достаточно для простых задач.

<?php
// Создание объекта даты
$date = new DateTime('2025-04-15 14:30:00', new DateTimeZone('Europe/Moscow'));
echo $date->format('Y-m-d H:i:s'); // 2025-04-15 14:30:00

// Изменение даты
$date->modify('+1 day');
echo $date->format('d.m.Y'); // 16.04.2025

// Разница между датами
$now = new DateTime();
$interval = $now->diff($date);
echo $interval->days; // количество дней
?>

Плюсы: встроен в PHP, не требует установки. Минусы: громоздкий синтаксис, нет цепочек методов (fluent interface), сложно работать с локализацией.

2. Carbon — самый популярный расширитель DateTime

Carbon — это библиотека, расширяющая DateTime. Она добавляет удобные методы для работы с датами, интервалами, часовыми поясами и локализацией. Установка через Composer:

composer require nesbot/carbon

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

<?php
use Carbon\Carbon;

// Текущая дата
$now = Carbon::now();
echo $now->toDateString(); // 2025-04-15

// Создание даты
$date = Carbon::create(2025, 12, 25, 10, 30, 0, 'Europe/Moscow');
echo $date->format('d.m.Y H:i'); // 25.12.2025 10:30

// Разница в человекочитаемом формате
echo Carbon::now()->subDays(5)->diffForHumans(); // "5 дней назад"

// Цепочки методов
$future = Carbon::now()->addWeek()->startOfDay();
echo $future->toDateTimeString(); // 2025-04-22 00:00:00

// Локализация
Carbon::setLocale('ru');
echo Carbon::now()->translatedFormat('l j F Y'); // "вторник 15 апреля 2025"
?>

Carbon поддерживает почти всё: манипуляции (addDays(), subMonths()), сравнения (isWeekend(), between()), форматирование с локализацией, работу с интервалами и периодами. Это стандарт де-факто для Laravel и многих проектов.

3. Chronos — легковесная альтернатива от CakePHP

Chronos — библиотека от команды CakePHP, также расширяющая DateTime. Она легче Carbon, но предоставляет схожий функционал. Установка:

composer require cakephp/chronos

Примеры:

<?php
use Cake\Chronos\Chronos;

// Создание и манипуляции
$date = Chronos::now();
$modified = $date->addDays(3)->subHours(2);
echo $modified->toIso8601String(); // 2025-04-18T12:30:00+03:00

// Разница с человекочитаемым выводом
$past = Chronos::parse('2025-04-10');
echo $past->diffForHumans(); // "5 дней назад"
?>

Chronos поддерживает мутабельные и иммутабельные версии (Chronos и ChronosImmutable). Отличается строгой типизацией и меньшим размером. Подходит, если не нужны все функции Carbon.

4. Сравнение библиотек

DateTime (встроенный) — базовый функционал, нет зависимостей, подходит для простых скриптов.
Carbon — богатый API, локализация, идеально для Laravel и сложных проектов.
Chronos — легковесный, иммутабельные объекты, хорош для CakePHP или приложений с ограничениями по размеру.