DateTime vs DateTimeOffset в C#: когда и что использовать?

Ключевое отличие: точка отсчёта

Главное различие между DateTime и DateTimeOffset — это способ представления момента во времени.

• DateTime — это просто календарная дата + время. Он не знает, в каком часовом поясе эта дата была получена. DateTime.Now даёт локальное время сервера, но теряет информацию о смещении.
• DateTimeOffset — это дата + время + смещение от UTC (например, +03:00, -05:00). Он точно определяет момент во времени, независимо от часового пояса.

Какой тип выбрать для хранения?

Если вы сохраняете момент в прошлом (дата регистрации, создания заказа, логи), всегда используйте DateTimeOffset или UTC-версию DateTime (DateTime.UtcNow). Почему?

// ПЛОХО: зависит от сервера
DateTime bad = DateTime.Now; // Если сервер в Москве (+03:00), то для пользователя в Нью-Йорке это будет неверное локальное время

// ХОРОШО: однозначный момент
DateTimeOffset good = DateTimeOffset.Now; // Хранит +03:00 или любое другое смещение
DateTime utcGood = DateTime.UtcNow; // Всегда UTC, но без смещения

Правило: если вы когда-нибудь захотите конвертировать эту дату в другой часовой пояс — используйте DateTimeOffset. Если дата всегда должна быть в UTC (например, для API) — используйте DateTime с Kind = Utc.

Работа с разными часовыми поясами

DateTimeOffset идеален для этого. Вы можете легко получить UTC-время и локальное время для любого пользователя:

// Сохраняем момент регистрации пользователя
DateTimeOffset registration = DateTimeOffset.Now;

// Пользователь из Нью-Йорка (UTC-5 зимой)
TimeZoneInfo nyZone = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time");
DateTime nyLocal = TimeZoneInfo.ConvertTime(registration, nyZone);

// Пользователь из Москвы (UTC+3)
TimeZoneInfo mskZone = TimeZoneInfo.FindSystemTimeZoneById("Russian Standard Time");
DateTime mskLocal = TimeZoneInfo.ConvertTime(registration, mskZone);

Console.WriteLine($"Регистрация (UTC): {registration.UtcDateTime}");
Console.WriteLine($"В Нью-Йорке: {nyLocal}");
Console.WriteLine($"В Москве: {mskLocal}");

Подводные камни

• Сериализация JSON: DateTime по умолчанию сериализуется без информации о часовом поясе. DateTimeOffset всегда включает смещение. Используйте DateTimeOffset в моделях API, чтобы избежать путаницы.
• Базы данных: SQL Server поддерживает тип datetimeoffset. Если вы используете Entity Framework, сопоставляйте DateTimeOffset с этим типом — это сохранит смещение.
• Арифметика: При вычитании двух DateTimeOffset вы получаете TimeSpan, который учитывает смещение. С DateTime вы рискуете получить неверный интервал, если складываете локальное и UTC-время.
• Летнее время: DateTimeOffset безопаснее — он фиксирует смещение в момент создания. DateTime может "съехать" на час при переходе на летнее/зимнее время.

Итог

Для большинства современных приложений используйте DateTimeOffset. Он даёт однозначность и гибкость. DateTime оставьте для:

• Дат без времени (дата рождения, дата начала отпуска).
• Случаев, когда вы точно знаете, что время всегда в UTC.
• Работы с устаревшими API, которые требуют DateTime.