TimeZoneInfo.ConvertTimeFromUtc(DateTime, TimeZoneInfo) 메서드

정의

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

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

예외

dateTimeKind 속성이 Local입니다.

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 조정 규칙을 적용합니다.

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

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

결과 변환 dateTime 이 날짜 및 시간 값보다 DateTime.MaxValueDateTime.MinValue 이전 또는 이후인 경우 이 메서드는 각각 반환 DateTime.MinValue 하거나 DateTime.MaxValue반환합니다.

적용 대상

추가 정보