TimeZoneInfo.ConvertTimeFromUtc(DateTime, TimeZoneInfo) 메서드

정의

네임스페이스:

System

어셈블리:

System.Runtime.dll

Source:

TimeZoneInfo.cs

UTC(협정 세계시)를 지정된 표준 시간대의 시간으로 변환합니다.

public:
 static DateTime ConvertTimeFromUtc(DateTime dateTime, TimeZoneInfo ^ destinationTimeZone);

public static DateTime ConvertTimeFromUtc (DateTime dateTime, TimeZoneInfo destinationTimeZone);

static member ConvertTimeFromUtc : DateTime * TimeZoneInfo -> DateTime

Public Shared Function ConvertTimeFromUtc (dateTime As DateTime, destinationTimeZone As TimeZoneInfo) As DateTime

매개 변수

dateTime

DateTime

UTC(협정 세계시)입니다.

destinationTimeZone

TimeZoneInfo

dateTime을 변환할 대상 표준 시간대입니다.

반환

DateTime

대상 표준 시간대의 날짜와 시간입니다. destinationTimeZone이 Utc이면 해당 Kind 속성은 Utc이고, 그렇지 않은 경우 해당 Kind 속성은 Unspecified입니다.

예외

ArgumentException

dateTime의 Kind 속성이 Local입니다.

ArgumentNullException

destinationTimeZone이(가) null인 경우

예제

다음 예제에서는 UTC(협정 세계시)를 중앙 시간으로 변환합니다.

DateTime timeUtc = DateTime.UtcNow;
try
{
   TimeZoneInfo cstZone = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time");
   DateTime cstTime = TimeZoneInfo.ConvertTimeFromUtc(timeUtc, cstZone);
   Console.WriteLine("The date and time are {0} {1}.", 
                     cstTime, 
                     cstZone.IsDaylightSavingTime(cstTime) ?
                             cstZone.DaylightName : cstZone.StandardName);
}
catch (TimeZoneNotFoundException)
{
   Console.WriteLine("The registry does not define the Central Standard Time zone.");
}                           
catch (InvalidTimeZoneException)
{
   Console.WriteLine("Registry data on the Central Standard Time zone has been corrupted.");
}

let timeUtc = DateTime.UtcNow
try
    let cstZone = TimeZoneInfo.FindSystemTimeZoneById "Central Standard Time"
    let cstTime = TimeZoneInfo.ConvertTimeFromUtc(timeUtc, cstZone)
    printfn $"The date and time are {cstTime} {if cstZone.IsDaylightSavingTime cstTime then cstZone.DaylightName else cstZone.StandardName}."
with
| :? TimeZoneNotFoundException ->
    printfn "The registry does not define the Central Standard Time zone."
| :? InvalidTimeZoneException ->
    printfn "Registry data on the Central Standard Time zone has been corrupted."

Dim timeUtc As Date = Date.UtcNow
Try
   Dim cstZone As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time")
   Dim cstTime As Date = TimeZoneInfo.ConvertTimeFromUtc(timeUtc, cstZone)
   Console.WriteLine("The date and time are {0} {1}.", _
                     cstTime, _
                     IIf(cstZone.IsDaylightSavingTime(cstTime), _
                         cstZone.DaylightName, cstZone.StandardName))
Catch e As TimeZoneNotFoundException
   Console.WriteLine("The registry does not define the Central Standard Time zone.")
Catch e As InvalidTimeZoneException
   Console.WriteLine("Registry data on the Central Standard Time zone has been corrupted.")
End Try

설명

변환을 수행할 때 메서드는 ConvertTimeFromUtc 표준 시간대에 적용되는 destinationTimeZone 조정 규칙을 적용합니다.

이 메서드의 정확한 동작은 다음 표와 같이 매개 변수의 KinddateTime 속성 값에 따라 달라집니다.

DateTime.Kind 속성	변환
DateTimeKind.Local	을 ArgumentExceptionthrow합니다.
DateTimeKind.Unspecified 또는 DateTimeKind.Utc	UTC(협정 세계시)에서 변환합니다.

의 변환 dateTime 으로 인해 보다 이전 DateTime.MinValue 또는 DateTime.MaxValue이후의 날짜 및 시간 값이 발생하는 경우 이 메서드는 각각 또는 DateTime.MaxValue를 반환 DateTime.MinValue 합니다.

추가 정보

• 표준 시간대 간 시간 변환