Разработка на PHP: Как реализовать метод add_days для расчета даты окончания подписки с учетом часовых поясов и перехода на летнее/зимнее время?

При разработке систем подписок на PHP одной из ключевых задач является корректный расчёт даты окончания подписки с учётом часовых поясов и перехода на летнее/зимнее время (DST — Daylight Saving Time). Использование простого прибавления секунд или дней через timestamp может привести к ошибкам на один час в дни перехода времени.

## Почему нельзя просто прибавить дни в секундах?

Если прибавить `$days * 86400` к Unix-timestamp, в день перехода на летнее время сутки длятся 23 часа, а на зимнее — 25. Это приведёт к смещению времени в итоговой дате.

## Правильный подход: использование DateTimeImmutable и DateTimeZone

PHP предоставляет мощные инструменты для работы с датами — классы `DateTime`, `DateTimeImmutable` и `DateInterval`. Рекомендуется использовать `DateTimeImmutable`, чтобы избежать мутации объекта.

php
function add_days(string $startDate, int $days, string $timezone = ‘Europe/Moscow’): string {
$tz = new DateTimeZone($timezone);
$date = new DateTimeImmutable($startDate, $tz);
$interval = new DateInterval(‘P’ . $days . ‘D’);
$endDate = $date->add($interval);
return $endDate->format(‘Y-m-d H:i:s’);
}

// Пример использования:
$subscriptionEnd = add_days(‘2024-03-10 12:00:00’, 30, ‘America/New_York’);
echo $subscriptionEnd; // 2024-04-09 12:00:00

При использовании `DateInterval` с форматом `P{n}D` PHP автоматически учитывает переход на летнее/зимнее время в рамках указанного часового пояса. Время суток (12:00:00) сохраняется корректно.

## Хранение дат в базе данных

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

php
function add_days_utc(string $startDateUtc, int $days, string $userTimezone): string {
$tz = new DateTimeZone($userTimezone);
$utcTz = new DateTimeZone(‘UTC’);

// Конвертируем UTC в часовой пояс пользователя
$date = new DateTimeImmutable($startDateUtc, $utcTz);
$dateInUserTz = $date->setTimezone($tz);

// Прибавляем дни в часовом поясе пользователя
$endDateInUserTz = $dateInUserTz->add(new DateInterval(‘P’ . $days . ‘D’));

// Возвращаем обратно в UTC для хранения
return $endDateInUserTz->setTimezone($utcTz)->format(‘Y-m-d H:i:s’);
}

## Важные рекомендации

1. **Всегда указывайте часовой пояс явно** — не полагайтесь на системный `date.timezone` из `php.ini`.
2. **Используйте IANA-идентификаторы** часовых поясов (`Europe/Moscow`, `America/New_York`), а не сокращения (`MSK`, `EST`).
3. **Храните даты в UTC** в базе данных — это стандарт для серверных приложений.
4. **Тестируйте граничные случаи** — даты вблизи перехода на летнее/зимнее время (март/ноябрь для США, март/октябрь для Европы).
5. **Используйте `DateTimeImmutable`** вместо `DateTime` для предотвращения случайной мутации объектов.

Такой подход обеспечивает точность расчётов независимо от региона пользователя и изменений в правилах перехода времени.