TimeZoneInfo.ConvertTime TimeZoneInfo.ConvertTime TimeZoneInfo.ConvertTime Method

정의

시간을 특정 표준 시간대의 시간으로 변환합니다.Converts a time to the time in a particular time zone.

오버로드

ConvertTime(DateTime, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo)

시간을 특정 표준 시간대의 시간으로 변환합니다.Converts a time to the time in a particular time zone.

ConvertTime(DateTimeOffset, TimeZoneInfo) ConvertTime(DateTimeOffset, TimeZoneInfo) ConvertTime(DateTimeOffset, TimeZoneInfo)

시간을 특정 표준 시간대의 시간으로 변환합니다.Converts a time to the time in a particular time zone.

ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)

시간을 한 표준 시간대에서 다른 표준 시간대로 변환합니다.Converts a time from one time zone to another.

ConvertTime(DateTime, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo)

시간을 특정 표준 시간대의 시간으로 변환합니다.Converts a time to the time in a particular time zone.

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

매개 변수

dateTime
DateTime DateTime DateTime

변환할 날짜 및 시간입니다.The date and time to convert.

destinationTimeZone
TimeZoneInfo TimeZoneInfo TimeZoneInfo

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

반환

대상 표준 시간대의 날짜와 시간입니다.The date and time in the destination time zone.

예외

dateTime 매개 변수 값이 잘못된 시간을 나타냅니다.The value of the dateTime parameter represents an invalid time.

destinationTimeZone 매개 변수의 값이 null입니다.The value of the destinationTimeZone parameter is null.

예제

다음 예제에서는 미국 및 캐나다 동부 표준 시간대의 시간을 날짜 및 시간 값의 배열을 변환합니다.The following example converts an array of date and time values to times in the Eastern Time zone of the U.S. and Canada. 원본 표준 시간대에 따라 달라 집니다 표시 합니다 DateTime.Kind 원본의 속성 DateTime 값입니다.It shows that the source time zone depends on the DateTime.Kind property of the source DateTime value. 또한 설명 하는 ConvertTime 오전 2 시에 원본 및 대상 표준 시간대의 표준 시간대 조정 발생 하므로 메서드는 계정으로 표준 시간대 조정It also illustrates that the ConvertTime method takes time zone adjustments into account, because a time zone adjustment occurs in both the source and destination time zones at 2:00 A.M. 2010 년 11 월 7 일입니다.on November 7, 2010.

using System;

public class Example
{
   public static void Main()
   {
      // Define times to be converted.
      DateTime[] times = { new DateTime(2010, 1, 1, 0, 1, 0), 
                           new DateTime(2010, 1, 1, 0, 1, 0, DateTimeKind.Utc), 
                           new DateTime(2010, 1, 1, 0, 1, 0, DateTimeKind.Local),                            
                           new DateTime(2010, 11, 6, 23, 30, 0),
                           new DateTime(2010, 11, 7, 2, 30, 0) };
                              
      // Retrieve the time zone for Eastern Standard Time (U.S. and Canada).
      TimeZoneInfo est; 
      try {
         est = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time");
      }
      catch (TimeZoneNotFoundException) {
         Console.WriteLine("Unable to retrieve the Eastern Standard time zone.");
         return;
      }
      catch (InvalidTimeZoneException) {
         Console.WriteLine("Unable to retrieve the Eastern Standard time zone.");
         return;
      }   

      // Display the current time zone name.
      Console.WriteLine("Local time zone: {0}\n", TimeZoneInfo.Local.DisplayName);
      
      // Convert each time in the array.
      foreach (DateTime timeToConvert in times)
      {
         DateTime targetTime = TimeZoneInfo.ConvertTime(timeToConvert, est);
         Console.WriteLine("Converted {0} {1} to {2}.", timeToConvert, 
                           timeToConvert.Kind, targetTime);
      }                        
   }
}
// The example displays the following output:
//    Local time zone: (GMT-08:00) Pacific Time (US & Canada)
//    
//    Converted 1/1/2010 12:01:00 AM Unspecified to 1/1/2010 3:01:00 AM.
//    Converted 1/1/2010 12:01:00 AM Utc to 12/31/2009 7:01:00 PM.
//    Converted 1/1/2010 12:01:00 AM Local to 1/1/2010 3:01:00 AM.
//    Converted 11/6/2010 11:30:00 PM Unspecified to 11/7/2010 1:30:00 AM.
//    Converted 11/7/2010 2:30:00 AM Unspecified to 11/7/2010 5:30:00 AM.
Module Example
   Public Sub Main()
      ' Define times to be converted.
      Dim times() As Date = { #1/1/2010 12:01AM#, _
                              DateTime.SpecifyKind(#1/1/2010 12:01AM#, DateTimeKind.Utc), _
                              DateTime.SpecifyKind(#1/1/2010 12:01AM#, DateTimeKind.Local), _
                              #11/6/2010 11:30PM#, #11/7/2010 2:30AM# }
                              
      ' Retrieve the time zone for Eastern Standard Time (U.S. and Canada).
      Dim est As TimeZoneInfo 
      Try
         est = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time")
      Catch e As TimeZoneNotFoundException
         Console.WriteLine("Unable to retrieve the Eastern Standard time zone.")
         Exit Sub
      Catch e As InvalidTimeZoneException
         Console.WriteLine("Unable to retrieve the Eastern Standard time zone.")
         Exit Sub
      End Try   

      ' Display the current time zone name.
      Console.WriteLine("Local time zone: {0}", TimeZoneInfo.Local.DisplayName)
      Console.WriteLine()
      
      ' Convert each time in the array.
      For Each timeToConvert As Date In times
         Dim targetTime As Date = TimeZoneInfo.ConvertTime(timeToConvert, est)
         Console.WriteLine("Converted {0} {1} to {2}.", timeToConvert, _
                           timeToConvert.Kind, targetTime)
      Next                        
   End Sub
End Module
' The example displays the following output:
'    Local time zone: (GMT-08:00) Pacific Time (US & Canada)
'    
'    Converted 1/1/2010 12:01:00 AM Unspecified to 1/1/2010 3:01:00 AM.
'    Converted 1/1/2010 12:01:00 AM Utc to 12/31/2009 7:01:00 PM.
'    Converted 1/1/2010 12:01:00 AM Local to 1/1/2010 3:01:00 AM.
'    Converted 11/6/2010 11:30:00 PM Unspecified to 11/7/2010 1:30:00 AM.
'    Converted 11/7/2010 2:30:00 AM Unspecified to 11/7/2010 5:30:00 AM.

설명

변환 수행 하는 경우는 ConvertTime(DateTimeOffset, TimeZoneInfo) 메서드는 모든 조정 규칙 적용에 적용 됩니다는 destinationTimeZone 표준 시간대입니다.When performing the conversion, the ConvertTime(DateTimeOffset, TimeZoneInfo) method applies any adjustment rules in effect in the destinationTimeZone time zone.

이 오버 로드는 ConvertTime(DateTime, TimeZoneInfo) 메서드는 원본 표준 시간대의 값에서을 결정 합니다 dateTime 매개 변수의 Kind 속성을 다음 표와 같이 합니다.This overload of the ConvertTime(DateTime, TimeZoneInfo) method determines the source time zone from the value of the dateTime parameter's Kind property, as the following table shows.

Kind 속성 값Kind property value 원본 표준 시간대Source time zone 메서드 동작Method behavior
DateTimeKind.Local Local 시간을 현지 시간 변환 destinationTimeZone합니다.Converts the local time to the time in destinationTimeZone.
DateTimeKind.Utc Utc Utc (협정 세계시) 시간으로 변환 destinationTimeZone합니다.Converts Coordinated Universal Time (UTC) to the time in destinationTimeZone.
DateTimeKind.Unspecified 간주 Local합니다.Assumed to be Local. 시간을 현지 시간 변환 destinationTimeZone합니다.Converts the local time to the time in destinationTimeZone.

합니다 Kind 반환 된 속성 DateTime 값이 다음 표와에서 같이 설정 합니다.The Kind property of the returned DateTime value is set as shown in the following table.

조건Condition Kind 속성 값 반환Returned Kind property value
destinationTimeZoneTimeZoneInfo.Utc인 경우The destinationTimeZone is TimeZoneInfo.Utc. DateTimeKind.Utc
destinationTimeZoneTimeZoneInfo.Local인 경우The destinationTimeZone is TimeZoneInfo.Local. DateTimeKind.Local
다른 모든 날짜 및 시간 값 및 대상 표준 시간대입니다.All other date and time values and destination time zones. DateTimeKind.Unspecified

경우 값은 dateTime 매개 변수는 모호한 현지 시간, 표준 시간으로 해석 됩니다.If the value of the dateTime parameter is an ambiguous local time, it is interpreted as a standard time. 경우는 dateTime 매개 변수는 잘못 된 현지 시간,이 메서드는 throw는 ArgumentException합니다.If the dateTime parameter is an invalid local time, this method throws an ArgumentException.

경우 변환 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.

호출 하 여 UTC에서을 변환할 수도 있습니다는 ConvertTimeFromUtcConvertTimeToUtc 메서드.You can also convert to or from UTC by calling the ConvertTimeFromUtc and ConvertTimeToUtc methods.

추가 정보

ConvertTime(DateTimeOffset, TimeZoneInfo) ConvertTime(DateTimeOffset, TimeZoneInfo) ConvertTime(DateTimeOffset, TimeZoneInfo)

시간을 특정 표준 시간대의 시간으로 변환합니다.Converts a time to the time in a particular time zone.

public:
 static DateTimeOffset ConvertTime(DateTimeOffset dateTimeOffset, TimeZoneInfo ^ destinationTimeZone);
public static DateTimeOffset ConvertTime (DateTimeOffset dateTimeOffset, TimeZoneInfo destinationTimeZone);
static member ConvertTime : DateTimeOffset * TimeZoneInfo -> DateTimeOffset

매개 변수

dateTimeOffset
DateTimeOffset DateTimeOffset DateTimeOffset

변환할 날짜 및 시간입니다.The date and time to convert.

destinationTimeZone
TimeZoneInfo TimeZoneInfo TimeZoneInfo

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

반환

대상 표준 시간대의 날짜와 시간입니다.The date and time in the destination time zone.

예외

destinationTimeZone 매개 변수의 값이 null입니다.The value of the destinationTimeZone parameter is null.

예제

다음 예제에서는 배열을 변환 DateTimeOffset 미국 및 캐나다 동부 표준 시간대의 시간 값입니다.The following example converts an array of DateTimeOffset values to times in the Eastern Time zone of the U.S. and Canada. 하는 방법을 보여 줍니다는 ConvertTime 오전 2 시에 원본 및 대상 표준 시간대의 표준 시간대 조정 발생 하므로 메서드는 계정으로 표준 시간대 조정It illustrates that the ConvertTime method takes time zone adjustments into account, because a time zone adjustment occurs in both the source and destination time zones at 2:00 A.M. 2010 년 11 월 7 일입니다.on November 7, 2010.

using System;

public class Example
{
   public static void Main()
   {
      // Define times to be converted.
      DateTime time1 = new DateTime(2010, 1, 1, 12, 1, 0);
      DateTime time2 = new DateTime(2010, 11, 6, 23, 30, 0);
      DateTimeOffset[] times = { new DateTimeOffset(time1, TimeZoneInfo.Local.GetUtcOffset(time1)),
                                 new DateTimeOffset(time1, TimeSpan.Zero),
                                 new DateTimeOffset(time2, TimeZoneInfo.Local.GetUtcOffset(time2)),
                                 new DateTimeOffset(time2.AddHours(3), TimeZoneInfo.Local.GetUtcOffset(time2.AddHours(3))) };
                              
      // Retrieve the time zone for Eastern Standard Time (U.S. and Canada).
      TimeZoneInfo est; 
      try {
         est = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time");
      }
      catch (TimeZoneNotFoundException) {
         Console.WriteLine("Unable to retrieve the Eastern Standard time zone.");
         return;
      }
      catch (InvalidTimeZoneException) {
         Console.WriteLine("Unable to retrieve the Eastern Standard time zone.");
         return;
      }   

      // Display the current time zone name.
      Console.WriteLine("Local time zone: {0}\n", TimeZoneInfo.Local.DisplayName);
      
      // Convert each time in the array.
      foreach (DateTimeOffset timeToConvert in times)
      {
         DateTimeOffset targetTime = TimeZoneInfo.ConvertTime(timeToConvert, est);
         Console.WriteLine("Converted {0} to {1}.", timeToConvert, targetTime);
      }                        
   }
}
// The example displays the following output:
//    Local time zone: (GMT-08:00) Pacific Time (US & Canada)
//    
//    Converted 1/1/2010 12:01:00 AM -08:00 to 1/1/2010 3:01:00 AM -05:00.
//    Converted 1/1/2010 12:01:00 AM +00:00 to 12/31/2009 7:01:00 PM -05:00.
//    Converted 11/6/2010 11:30:00 PM -07:00 to 11/7/2010 1:30:00 AM -05:00.
//    Converted 11/7/2010 2:30:00 AM -08:00 to 11/7/2010 5:30:00 AM -05:00.
Module Example
   Public Sub Main()
      ' Define times to be converted.
      Dim time1 As Date = #1/1/2010 12:01AM#
      Dim time2 As Date = #11/6/2010 11:30PM#
      Dim times() As DateTimeOffset = { New DateTimeOffset(time1, TimeZoneInfo.Local.GetUtcOffset(time1)), _
                                        New DateTimeOffset(time1, Timespan.Zero), _
                                        New DateTimeOffset(time2, TimeZoneInfo.Local.GetUtcOffset(time2)), _
                                        New DateTimeOffset(time2.AddHours(3), TimeZoneInfo.Local.GetUtcOffset(time2.AddHours(3))) }
                              
      ' Retrieve the time zone for Eastern Standard Time (U.S. and Canada).
      Dim est As TimeZoneInfo 
      Try
         est = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time")
      Catch e As TimeZoneNotFoundException
         Console.WriteLine("Unable to retrieve the Eastern Standard time zone.")
         Exit Sub
      Catch e As InvalidTimeZoneException
         Console.WriteLine("Unable to retrieve the Eastern Standard time zone.")
         Exit Sub
      End Try   

      ' Display the current time zone name.
      Console.WriteLine("Local time zone: {0}", TimeZoneInfo.Local.DisplayName)
      Console.WriteLine()
      
      ' Convert each time in the array.
      For Each timeToConvert As DateTimeOffset In times
         Dim targetTime As DateTimeOffset = TimeZoneInfo.ConvertTime(timeToConvert, est)
         Console.WriteLine("Converted {0} to {1}.", timeToConvert, targetTime)
      Next                        
   End Sub
End Module
' The example displays the following output:
'    Local time zone: (GMT-08:00) Pacific Time (US & Canada)
'    
'    Converted 1/1/2010 12:01:00 AM -08:00 to 1/1/2010 3:01:00 AM -05:00.
'    Converted 1/1/2010 12:01:00 AM +00:00 to 12/31/2009 7:01:00 PM -05:00.
'    Converted 11/6/2010 11:30:00 PM -07:00 to 11/7/2010 1:30:00 AM -05:00.
'    Converted 11/7/2010 2:30:00 AM -08:00 to 11/7/2010 5:30:00 AM -05:00.

설명

변환 수행 하는 경우는 ConvertTime(DateTimeOffset, TimeZoneInfo) 메서드는 모든 조정 규칙 적용에 적용 됩니다는 destinationTimeZone 표준 시간대입니다.When performing the conversion, the ConvertTime(DateTimeOffset, TimeZoneInfo) method applies any adjustment rules in effect in the destinationTimeZone time zone.

다른 오버 로드에서 다른이 오버 로드는 ConvertTime 그대로 사용 하 여 메서드를 DateTimeOffset 첫 번째 매개 변수로 값입니다.This overload differs from the other overloads of the ConvertTime method by accepting a DateTimeOffset value as its first parameter. 특정 표준 시간대의 시간과 날짜 아니라 utc (협정 세계시) 오프셋으로 날짜 및 시간을 식별합니다.This identifies the date and time as an offset from Coordinated Universal Time (UTC) rather than as the date and time in a particular time zone. 결과적으로 dateTimeOffset 매개 변수는 모호한 시간이 나 잘못 된 시간을 나타낼 수 없습니다.As a result, the dateTimeOffset parameter cannot represent either an ambiguous time or an invalid time.

변환 된 dateTimeOffset 이 메서드는 대상 표준 시간대의 시간 값은 고려 대상 표준 시간대에서 실제로 모든 조정 규칙입니다.In converting the dateTimeOffset value to the time in the destination time zone, this method takes into account any adjustment rules in effect in the destination time zone.

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

추가 정보

ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)

시간을 한 표준 시간대에서 다른 표준 시간대로 변환합니다.Converts a time from one time zone to another.

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

매개 변수

dateTime
DateTime DateTime DateTime

변환할 날짜 및 시간입니다.The date and time to convert.

sourceTimeZone
TimeZoneInfo TimeZoneInfo TimeZoneInfo

dateTime의 표준 시간대입니다.The time zone of dateTime.

destinationTimeZone
TimeZoneInfo TimeZoneInfo TimeZoneInfo

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

반환

소스 표준 시간대의 dateTime 매개 변수에 해당하는 대상 표준 시간대의 날짜 및 시간입니다.The date and time in the destination time zone that corresponds to the dateTime parameter in the source time zone.

예외

dateTime 매개 변수의 Kind 속성이 Local이지만 sourceTimeZone 매개 변수가 Local와 다른 경우The Kind property of the dateTime parameter is Local, but the sourceTimeZone parameter does not equal Local.

또는-or- dateTime 매개 변수의 Kind 속성이 Utc이지만 sourceTimeZone 매개 변수가 Utc와 다른 경우The Kind property of the dateTime parameter is Utc, but the sourceTimeZone parameter does not equal Utc.

또는-or- dateTime 매개 변수가 잘못된 시간인 경우(즉, 표준 시간대의 조정 규칙 때문에 존재하지 않는 시간을 나타냄)The dateTime parameter is an invalid time (that is, it represents a time that does not exist because of a time zone's adjustment rules).

sourceTimeZone 매개 변수가 null인 경우The sourceTimeZone parameter is null.

또는-or- destinationTimeZone 매개 변수가 null인 경우The destinationTimeZone parameter is null.

예제

다음 예제를 사용 하 여 ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) 하와이 표준시를 현지 시간으로 변환 하는 방법입니다.The following example illustrates the use of the ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) method to convert from Hawaiian Standard Time to local time.

DateTime hwTime = new DateTime(2007, 02, 01, 08, 00, 00);
try
{
   TimeZoneInfo hwZone = TimeZoneInfo.FindSystemTimeZoneById("Hawaiian Standard Time");
   Console.WriteLine("{0} {1} is {2} local time.", 
           hwTime, 
           hwZone.IsDaylightSavingTime(hwTime) ? hwZone.DaylightName : hwZone.StandardName, 
           TimeZoneInfo.ConvertTime(hwTime, hwZone, TimeZoneInfo.Local));
}
catch (TimeZoneNotFoundException)
{
   Console.WriteLine("The registry does not define the Hawaiian Standard Time zone.");
}                           
catch (InvalidTimeZoneException)
{
   Console.WriteLine("Registry data on the Hawaiian Standard Time zone has been corrupted.");
}
Dim hwTime As Date = #2/01/2007 8:00:00 AM#
Try
   Dim hwZone As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById("Hawaiian Standard Time")
   Console.WriteLine("{0} {1} is {2} local time.", _
                     hwTime, _
                     IIf(hwZone.IsDaylightSavingTime(hwTime), hwZone.DaylightName, hwZone.StandardName), _
                     TimeZoneInfo.ConvertTime(hwTime, hwZone, TimeZoneInfo.Local))
Catch e As TimeZoneNotFoundException
   Console.WriteLine("The registry does not define the Hawaiian Standard Time zone.")
Catch e As InvalidTimeZoneException
   Console.WriteLine("Registry data on the Hawaiian Standard Time zone has been corrupted.")
End Try                     

설명

변환 수행 하는 경우는 ConvertTime 메서드는 모든 조정 규칙 적용에 적용 됩니다는 destinationTimeZone 표준 시간대입니다.When performing the conversion, the ConvertTime method applies any adjustment rules in effect in the destinationTimeZone time zone.

값을 Kind 의 속성을 dateTime 매개 변수 일치 해야 합니다를 sourceTimeZone 매개 변수를 다음 표와 같이 합니다.The value of the Kind property of the dateTime parameter must correspond to the sourceTimeZone parameter, as the following table shows.

DateTime.Kind 값DateTime.Kind value sourceTimeZone 값sourceTimeZone value 메서드 동작Method behavior
DateTimeKind.Utc Equals TimeZoneInfo.Utc합니다.Equals TimeZoneInfo.Utc. 변환 dateTime 대상 표준 시간대의 시간입니다.Converts dateTime to the destination time zone's time.
DateTimeKind.Utc Does not equal TimeZoneInfo.Utc인 경우Does not equal TimeZoneInfo.Utc. Throw는 ArgumentException합니다.Throws an ArgumentException.
DateTimeKind.Local Equals TimeZoneInfo.Local합니다.Equals TimeZoneInfo.Local. 변환 dateTime 대상 표준 시간대의 시간입니다.Converts dateTime to the destination time zone's time.
DateTimeKind.Local Does not equal TimeZoneInfo.Local인 경우Does not equal TimeZoneInfo.Local. Throw는 ArgumentException합니다.Throws an ArgumentException.
DateTimeKind.Unspecified 모든 합니다.Any. 변환 dateTime 대상 표준 시간대의 시간입니다.Converts dateTime to the destination time zone's time.

호출 하 여 또는 utc (협정 세계시)을 변환할 수도 있습니다는 ConvertTimeFromUtcConvertTimeToUtc 메서드.You can also convert to or from Coordinated Universal Time (UTC) by calling the ConvertTimeFromUtc and ConvertTimeToUtc methods.

합니다 Kind 반환 된 속성 DateTime 값이 다음 표와에서 같이 설정 합니다.The Kind property of the returned DateTime value is set as shown in the following table.

조건Condition Kind 속성 값 반환Returned Kind property value
destinationTimeZone 인수가 TimeZoneInfo.Utc인 경우The destinationTimeZone argument is TimeZoneInfo.Utc. DateTimeKind.Utc
destinationTimeZone 인수가 TimeZoneInfo.Local인 경우The destinationTimeZone argument is TimeZoneInfo.Local. DateTimeKind.Local
모든 다른 날짜 및 시간 값, 원본 표준 시간대 및 대상 표준 시간대입니다.All other date and time values, source time zones, and destination time zones. DateTimeKind.Unspecified

경우 값은 dateTime 매개 변수는 원본 표준 시간대에서 모호한 시간, 표준 시간으로 해석 됩니다.If the value of the dateTime parameter is an ambiguous time in the source time zone, it is interpreted as a standard time. 경우는 dateTime 매개 변수는 원본 표준 시간대에서 잘못 된 시간,이 메서드는 throw는 ArgumentException합니다.If the dateTime parameter is an invalid time in the source time zone, this method throws an ArgumentException.

경우 변환 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.

ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) 메서드가 throw는 ArgumentException 예외 경우를 DateTime.Kind 의 속성을 dateTime 인수가 DateTimeKind.Local 하지만 sourceTimeZone 인수가 아닙니다 TimeZoneInfo.Local.The ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) method throws an ArgumentException exception if the DateTime.Kind property of the dateTime argument is DateTimeKind.Local but the sourceTimeZone argument is not TimeZoneInfo.Local. 메서드를 사용 하 여 값이 같은지 테스트 하는 대신 참조 같음에 대 한 테스트 현지 표준 시간대 또는 범용 표준 시간대는 원본 표준 시간대 인지 확인 하는 Equals(TimeZoneInfo) 메서드.To determine whether the source time zone is the local time zone or the universal time zone, the method tests for reference equality instead of testing for value equality with the Equals(TimeZoneInfo) method. 유의 TimeZoneInfo 호출 하 여 검색 되는 현지 표준 시간대를 나타내는 개체를 FindSystemTimeZoneById 메서드 사용 하 여 참조 같음 없는 TimeZoneInfo.Local합니다.Note that TimeZoneInfo objects that represent the local time zone and that are retrieved by calling the FindSystemTimeZoneById method do not have referential equality with TimeZoneInfo.Local. 게다가 TimeZoneInfo 반환 하는 컬렉션을 반복 하 여 검색 되는 로컬 또는 범용 표준 시간대를 나타내는 개체를 GetSystemTimeZones 메서드 사용 하 여 참조 같음 없는 TimeZoneInfo.Local 또는 TimeZoneInfo.Utc합니다.Furthermore, TimeZoneInfo objects that represent the local or universal time zone and that are retrieved by iterating the collection returned by the GetSystemTimeZones method do not have referential equality with TimeZoneInfo.Local or TimeZoneInfo.Utc. 호출할 수 있습니다는 ConvertTimeBySystemTimeZoneId(DateTime, String, String) 메서드.As an alternative, you can call the ConvertTimeBySystemTimeZoneId(DateTime, String, String) method.

추가 정보

적용 대상