원하는 시간대의 날짜와 시간을 표시하기 위한 DateTimeOffset

클라우드에서 실행되는 웹 응용프로그램에서 날짜-시간 값을 처리할 때, DateTime 보다는 DateTimeOffset 형식으로 자료를 처리하면 개인화된 시간 표시를 보다 편리하게 지원할 수 있습니다.

클라우드에서 실행되는 웹 응용프로그램은 웹 서버의 시간대에 의지할 수 없는 경우가 많습니다.

예를 들면, 한국 지역의 웹서버를 선택해서 웹 응용프로그램을 게시했지만, 웹 서버의 시간대를 조정할 수 없는 경우 자료는 UTC 시각으로 저장되고, 표시를 원하는 시간대로 표시할 수 있습니다.

🔔 DateTimeOffset

DateTimeOffset 구조체는 UTC (Coordinated Universal Time)를 기준으로 한 날짜 및 시간으로 표시되는 특정 시점을 나타냅니다.

DateTime 속성

날짜와 시각을 표현하는 구조체입니다.

Offset 속성

UTC를 기준으로 한 시간(Hour) 차이를 나타냅니다.

-14 ~ 14 사이의 값입니다.

🔔 Timezone

TimeInfo 인스턴스를 얻기위해 사용되는 Id, StandardName의 목록입니다.

Console.WriteLine($"| Id | Standard name | Offset |");
Console.WriteLine($"| :- | :- | :- |");
foreach (var timezone in TimeZoneInfo.GetSystemTimeZones().OrderBy(z=>z.BaseUtcOffset))
{
    Console.WriteLine($"| {timezone.Id} | {timezone.StandardName} | {timezone.BaseUtcOffset} |");
}

🔔 시간대 변경

TimeZoneInfo 클래스를 사용해서 간편하게 원하는 시간대의 시각으로 변경할 수 있습니다.

public static class DateTimeOffsetExtensions
{
    /// <summary>
    /// 지정된 시간대에 해당하는 시각을 계산합니다.
    /// </summary>
    /// <param name="dateTimeOffset"></param>
    /// <param name="timeZoneId">시간대 식별자</param>
    /// <returns></returns>
    public static DateTimeOffset ToLocalDateTime(this DateTimeOffset dateTimeOffset, string timeZoneId)
    {
        var timeZoneInfo = TimeZoneInfo.GetSystemTimeZones()
            .Where(t => t.Id.Equals(timeZoneId, StringComparison.OrdinalIgnoreCase))
            .FirstOrDefault();

        var localTime = TimeZoneInfo.ConvertTime(dateTimeOffset, timeZoneInfo);

        return localTime;
    }
}

👁‍🗨 코드

Github 에서 간략한 예제를 확인할 수 있습니다.