Работа с датами и временем в C#: продвинутые техники и советы

Продвинутая работа с датами и временем в C#: от теории к реальным задачам

Работа с датами и временем — одна из самых частых и одновременно коварных задач в разработке. На начальном уровне мы просто создаём DateTime.Now и выводим его в консоль. Но когда проект перерастает игрушечные рамки, появляются сложности: переход на летнее время, разные часовые пояса, высокая точность вычислений или необходимость работы с датами без временной зоны. В этой статье мы разберём продвинутые техники работы с датами и временем в C# (.NET), которые помогут вам писать надёжный и предсказуемый код.

1. DateTime, DateTimeOffset и TimeSpan: выбираем правильный инструмент

Многие разработчики используют DateTime по умолчанию, не задумываясь о его ограничениях. На продвинутом уровне важно понимать разницу между тремя основными типами.

DateTime

Хранит дату и время. Его главная проблема — неоднозначность. Свойство Kind (Local, Utc, Unspecified) не всегда задаётся явно, что приводит к ошибкам при сериализации или сравнении.

DateTimeOffset

Хранит дату, время и смещение относительно UTC. Это рекомендуемый тип для хранения моментов времени, так как он однозначно определяет точку на временной шкале. Например, 2025-03-15T14:00:00+03:00 — это всегда конкретный момент, независимо от часового пояса пользователя.

TimeSpan

Представляет интервал времени, а не конкретный момент. Используется для арифметики: разница между датами, таймауты, длительность операций.

// Пример: DateTime vs DateTimeOffset
DateTime localNow = DateTime.Now; // Kind = Local
DateTime utcNow = DateTime.UtcNow; // Kind = Utc

DateTimeOffset preciseNow = DateTimeOffset.Now; // Всегда с указанием смещения

// Сравнение: DateTimeOffset однозначнее
Console.WriteLine(preciseNow.Offset); // +03:00 или -05:00 и т.д.

Совет: Для новых проектов используйте DateTimeOffset для хранения моментов времени, TimeSpan — для интервалов, а DateTime — только когда это действительно необходимо (например, для совместимости со старым кодом).

2. Парсинг и форматирование: как не получить FormatException

Парсинг дат из строк — источник множества ошибок, особенно если строки приходят от пользователей или из разных культур.

Культурно-зависимый парсинг

Используйте CultureInfo.InvariantCulture для внутреннего обмена данными (например, JSON, API). Для пользовательского ввода — учитывайте культуру пользователя.

// Парсинг с учётом культуры
string dateString = "15.03.2025";
var ruCulture = new CultureInfo("ru-RU");
DateTime parsedDate = DateTime.Parse(dateString, ruCulture);

// Инвариантный парсинг (рекомендуется для API)
string isoString = "2025-03-15T14:00:00Z";
DateTimeOffset parsedIso = DateTimeOffset.Parse(isoString, CultureInfo.InvariantCulture, DateTimeStyles.RoundtripKind);

TryParseExact для надёжности

Если формат строки известен, используйте TryParseExact с явным указанием формата. Это исключает неожиданные исключения.

string input = "2025-03-15 14:30";
string format = "yyyy-MM-dd HH:mm";
if (DateTime.TryParseExact(input, format, CultureInfo.InvariantCulture, DateTimeStyles.None, out DateTime result))
{
    Console.WriteLine($"Успешно: {result}");
}
else
{
    Console.WriteLine("Ошибка парсинга");
}

Кастомное форматирование

Стандартные спецификаторы (d, D, t, T) хороши, но для точного контроля используйте кастомные строки формата.

DateTime now = DateTime.Now;
Console.WriteLine(now.ToString("yyyy-MM-dd HH:mm:ss.fff")); // 2025-03-15 14:30:45.123
Console.WriteLine(now.ToString("dd MMMM yyyy, dddd"));      // 15 марта 2025, суббота

3. Часовые пояса и переход на летнее время

Это самая сложная часть работы с датами. Игнорирование часовых поясов приводит к багам, которые проявляются только два раза в год (при переводе часов) или при работе с международными пользователями.

TimeZoneInfo: правильное преобразование

Не используйте TimeZone.CurrentTimeZone — он устарел. Работайте через TimeZoneInfo.

// Получение часового пояса
TimeZoneInfo moscowZone = TimeZoneInfo.FindSystemTimeZoneById("Russian Standard Time");
TimeZoneInfo utcZone = TimeZoneInfo.Utc;

// Конвертация
DateTimeOffset utcTime = DateTimeOffset.UtcNow;
DateTimeOffset moscowTime = TimeZoneInfo.ConvertTime(utcTime, moscowZone);

Console.WriteLine($"UTC: {utcTime}");
Console.WriteLine($"Москва: {moscowTime}");

Проблема неоднозначного времени

При переходе на летнее/зимнее время одно и то же локальное время может существовать дважды (осенью) или отсутствовать (весной). TimeZoneInfo предоставляет методы для обработки таких ситуаций.

// Проверка на неоднозначность и несуществующее время
TimeZoneInfo tz = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time");
DateTime ambiguousTime = new DateTime(2025, 11, 2, 1, 30, 0); // Переход на зимнее время

if (tz.IsAmbiguousTime(ambiguousTime))
{
    Console.WriteLine("Время неоднозначно — существует два разных UTC-момента");
}

DateTime invalidTime = new DateTime(2025, 3, 9, 2, 30, 0); // Переход на летнее время
if (tz.IsInvalidTime(invalidTime))
{
    Console.WriteLine("Такого времени не существует — часы перевели вперёд");
}

TimeOnly и DateOnly (C# 10+)

Если вам нужно только время (например, время начала рабочего дня) или только дата (день рождения), используйте TimeOnly и DateOnly. Они легче и безопаснее, чем DateTime с игнорируемыми компонентами.

DateOnly birthday = new DateOnly(1990, 5, 20);
TimeOnly alarmTime = new TimeOnly(7, 30);

Console.WriteLine($"День рождения: {birthday