// Создание и свойства
DateOnly d1 = new DateOnly(2021, 5, 31);
Console.WriteLine(d1.Year);      // 2021
Console.WriteLine(d1.Month);     // 5
Console.WriteLine(d1.Day);       // 31
Console.WriteLine(d1.DayOfWeek); // Monday
// Манипуляции
DateOnly d2 = d1.AddMonths(1);  // Можно прибавлять дни, месяцы или годы. Для вычитания используйте отрицательные значения.
Console.WriteLine(d2);     // Результат: "6/30/2021" (обратите внимание: без указания времени)
// С помощью свойства DayNumber можно вычислить разницу между двумя датами в сутках
int days = d2.DayNumber - d1.DayNumber;
Console.WriteLine($"{d2} наступит через {days} суток после {d1}");
// Парсинг и токены форматирования строк работают работают ожидаемым образом
DateOnly d3 = DateOnly.ParseExact("31 Dec 1980", "dd MMM yyyy", CultureInfo.InvariantCulture);  // Пользовательский формат
Console.WriteLine(d3.ToString("o", CultureInfo.InvariantCulture));   // Результат: "1980-12-31" (формат ISO 8601)
// Можно сочетать с TimeOnly, чтобы получить дату и время (DateTime)
DateTime dt = d3.ToDateTime(new TimeOnly(0, 0));
Console.WriteLine(dt);       // Результат: "12/31/1980 12:00:00 AM"
// Если нужна текущая дата (в местном часовом поясе)
DateOnly today = DateOnly.FromDateTime(DateTime.Today);

Calendar hebrewCalendar = new HebrewCalendar();
DateOnly d4 = new DateOnly(5781, 9, 16, hebrewCalendar);                   // 16 сивана 5781 г.
Console.WriteLine(d4.ToString("d MMMM yyyy", CultureInfo.InvariantCulture)); // 27 мая 2021 г.
Подробные сведения см. в руководстве по работе с календарями.

// Создание и свойства
TimeOnly t1 = new TimeOnly(16, 30);
Console.WriteLine(t1.Hour);      // 16
Console.WriteLine(t1.Minute);    // 30
Console.WriteLine(t1.Second);    // 0
// Можно прибавлять часы, минуты или период времени TimeSpan (или использовать отрицательные значения для вычитания).
TimeOnly t2 = t1.AddHours(10);
Console.WriteLine(t2);     // Результат: "2:30 AM" (обратите внимание, что даты нет, а время уже перешло через полночь)
// При необходимости можно вычислить, сколько прошло суток за указанный период (= сколько раз часы показывали полночь).
TimeOnly t3 = t2.AddMinutes(5000, out int wrappedDays);
Console.WriteLine($"{t3}, {wrappedDays} суток спустя");  // Результат: "1:50 PM, 3 суток спустя"
// Значения времени можно вычитать, чтобы узнать временной промежуток между ними.
// Операция должна выглядеть как "конечное время - начальное время". Порядок важен, так как это циклические часы.  Пример:
TimeOnly t4 = new TimeOnly(2, 0);  // 2:00
TimeOnly t5 = new TimeOnly(21, 0); // 21:00
TimeSpan x = t5 - t4;
TimeSpan y = t4 - t5;
Console.WriteLine($"{t5} наступит через {x.TotalHours} ч. после {t4}"); // 19 часов
Console.WriteLine($"{t4} наступит через {x.TotalHours} ч. после {t5}"); // 5 часов
// Парсинг и токены форматирования строк работают работают ожидаемым образом
TimeOnly t6 = TimeOnly.ParseExact("5:00 pm", "h:mm tt", CultureInfo.InvariantCulture);  // Пользовательский формат
Console.WriteLine(t6.ToString("T", CultureInfo.InvariantCulture));   // Результат: "17:00:00" (длинный формат времени)
// Можно преобразовать TimeOnly в TimeSpan для использования с прежними API
TimeSpan ts = t6.ToTimeSpan();
Console.WriteLine(ts);      // "17:00:00"
// Или скомбинировать с DateOnly, чтобы получить DateTime
DateTime dt = new DateOnly(1970, 1, 1).ToDateTime(t6);
Console.WriteLine(dt);       // Результат: "1/1/1970 5:00:00 PM"
// Если требуется текущее время (в местном часовом поясе)
TimeOnly now = TimeOnly.FromDateTime(DateTime.Now);
// Можно определить, находится ли время между двумя другими значениями времени
if (now.IsBetween(t1, t2))
    Console.WriteLine($"{now} находится между {t1} и {t2}");
else
    Console.WriteLine($"{now} НЕ находится между {t1} и {t2}");

// Оба идентификатора теперь работают в любых поддерживаемых ОС, где доступны данные часовых поясов и ICU.
TimeZoneInfo tzi1 = TimeZoneInfo.FindSystemTimeZoneById("AUS Eastern Standard Time");
TimeZoneInfo tzi2 = TimeZoneInfo.FindSystemTimeZoneById("Australia/Sydney");

// Преобразование из формата IANA в Windows
string ianaId1 = "America/Los_Angeles";
if (!TimeZoneInfo.TryConvertIanaIdToWindowsId(ianaId1, out string winId1))
    throw new TimeZoneNotFoundException($"Часовой пояс Windows для "{ianaId1}" не найден.");
Console.WriteLine($"{ianaId1} => {winId1}");  // "America/Los_Angeles => Pacific Standard Time"
// Преобразование из формата Windows в IANA при неизвестном регионе
string winId2 = "Eastern Standard Time";
if (!TimeZoneInfo.TryConvertWindowsIdToIanaId(winId2, out string ianaId2))
    throw new TimeZoneNotFoundException($"Часовой пояс IANA для "{winId2}" не найден.");
Console.WriteLine($"{winId2} => {ianaId2}");  // "Eastern Standard Time => America/New_York"
// Преобразование из формата Windows в IANA при известном регионе
string winId3 = "Eastern Standard Time";
string region = "CA"; // Канада
if (!TimeZoneInfo.TryConvertWindowsIdToIanaId(winId3, region, out string ianaId3))
    throw new TimeZoneNotFoundException($"Часовой пояс IANA для "{winId3}" в регионе "{region}" не найден.");
Console.WriteLine($"{winId3} + {region} => {ianaId3}");  // "Eastern Standard Time + CA => America/Toronto"

static string GetIanaTimeZoneId(TimeZoneInfo tzi)
{
    if (tzi.HasIanaId)
        return tzi.Id;  // Преобразование не требуется
    if (TimeZoneInfo.TryConvertWindowsIdToIanaId(tzi.Id, out string ianaId))
        return ianaId;  // Использовать преобразованный идентификатор
    throw new TimeZoneNotFoundException($"Часовой пояс IANA для "{tzi.Id}" не найден.");
}

static string GetWindowsTimeZoneId(TimeZoneInfo tzi)
{
    if (!tzi.HasIanaId)
        return tzi.Id;  // Преобразование не требуется
    if (TimeZoneInfo.TryConvertIanaIdToWindowsId(tzi.Id, out string winId))
        return winId;   // Использовать преобразованный идентификатор
    throw new TimeZoneNotFoundException($"Часовой пояс Windows для "{tzi.Id}" не найден.");
}