TimeZoneInfo.ConvertTimeFromUtc(DateTime, TimeZoneInfo) TimeZoneInfo.ConvertTimeFromUtc(DateTime, TimeZoneInfo) TimeZoneInfo.ConvertTimeFromUtc(DateTime, TimeZoneInfo) Method

정의

UTC(협정 세계시)를 지정된 표준 시간대의 시간으로 변환합니다.Converts a Coordinated Universal Time (UTC) to the time in a specified time zone.

public:
 static DateTime ConvertTimeFromUtc(DateTime dateTime, TimeZoneInfo ^ destinationTimeZone);
public static DateTime ConvertTimeFromUtc (DateTime dateTime, TimeZoneInfo destinationTimeZone);
static member ConvertTimeFromUtc : DateTime * TimeZoneInfo -> DateTime

매개 변수

dateTime
DateTime DateTime DateTime

UTC(협정 세계시)입니다.The Coordinated Universal Time (UTC).

destinationTimeZone
TimeZoneInfo TimeZoneInfo TimeZoneInfo

dateTime을 변환할 대상 표준 시간대입니다.The time zone to convert dateTime to.

반환

대상 표준 시간대의 날짜와 시간입니다.The date and time in the destination time zone. destinationTimeZoneUtc이면 해당 Kind 속성은 Utc이고, 그렇지 않은 경우 해당 Kind 속성은 Unspecified입니다.Its Kind property is Utc if destinationTimeZone is Utc; otherwise, its Kind property is Unspecified.

예외

dateTimeKind 속성이 Local입니다.The Kind property of dateTime is Local.

destinationTimeZonenull인 경우destinationTimeZone is null.

예제

다음 예제에서는 중부 표준시를 utc (협정 세계시)를 변환합니다.The following example converts Coordinated Universal Time (UTC) to Central Time.

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.");
}
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 표준 시간대입니다.When performing the conversion, the ConvertTimeFromUtc method applies any adjustment rules in effect in the destinationTimeZone time zone.

이 메서드의 정확한 동작은 값에 따라 달라 집니다를 Kind 의 속성을 dateTime 매개 변수를 다음 표와 같이 합니다.The precise behavior of this method depends on the value of the Kind property of the dateTime parameter, as the following table shows.

DateTime.Kind 속성DateTime.Kind property 변환Conversion
DateTimeKind.Local Throw는 ArgumentException합니다.Throws an ArgumentException.
DateTimeKind.Unspecified 또는 DateTimeKind.UtcDateTimeKind.Unspecified or DateTimeKind.Utc UTC (Coordinated Universal Time)에서 변환합니다.Converts from Coordinated Universal Time (UTC).

경우 변환 dateTime 의 결과 보다 이전 날짜 및 시간 값 DateTime.MinValue 보다 이후 이거나 DateTime.MaxValue,이 메서드는 반환 DateTime.MinValue 또는 DateTime.MaxValue각각.If the conversion of dateTime results in a date and time value that is earlier than DateTime.MinValue or later than DateTime.MaxValue, this method returns DateTime.MinValue or DateTime.MaxValue, respectively.

적용 대상

추가 정보