TimeZoneInfo.ConvertTime TimeZoneInfo.ConvertTime TimeZoneInfo.ConvertTime Method

Definition

Konvertiert eine Zeit in die Zeit in einer bestimmten Zeitzone.Converts a time to the time in a particular time zone.

Überlädt

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

Konvertiert eine Zeit in die Zeit in einer bestimmten Zeitzone.Converts a time to the time in a particular time zone.

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

Konvertiert eine Zeit in die Zeit in einer bestimmten Zeitzone.Converts a time to the time in a particular time zone.

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

Konvertiert eine Zeit aus einer Zeitzone in ein andere.Converts a time from one time zone to another.

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

Konvertiert eine Zeit in die Zeit in einer bestimmten Zeitzone.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

Parameter

dateTime
DateTime DateTime DateTime

Das Datum und die Uhrzeit, die konvertiert werden sollen.The date and time to convert.

destinationTimeZone
TimeZoneInfo TimeZoneInfo TimeZoneInfo

Die Zeitzone, in die dateTime konvertiert werden soll.The time zone to convert dateTime to.

Gibt zurück

Das Datum und die Uhrzeit in der Zielzeitzone.The date and time in the destination time zone.

Ausnahmen

Der Wert des dateTime-Parameters, der eine ungültige Zeit darstellt.The value of the dateTime parameter represents an invalid time.

Der Wert des destinationTimeZone-Parameters ist null.The value of the destinationTimeZone parameter is null.

Beispiele

Im folgenden Beispiel wird ein Array von Datums-und Uhrzeitwerten in Uhrzeiten in der Eastern Time Zone der USA und Kanada konvertiert.The following example converts an array of date and time values to times in the Eastern Time zone of the U.S. and Canada. Es zeigt, dass die Quell Zeitzone von der DateTime.Kind Eigenschaft des Quell DateTime Werts abhängig ist.It shows that the source time zone depends on the DateTime.Kind property of the source DateTime value. Außerdem wird veranschaulicht, dass ConvertTime die-Methode Zeit Zonen Anpassungen berücksichtigt, da eine Zeit Zonen Anpassung in den Quell-und Ziel Zeitzonen um 2:00 Uhr stattfindet.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. am 7. November 2010.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.

Hinweise

Beim Durchführen der Konvertierung wendet ConvertTime(DateTimeOffset, TimeZoneInfo) die-Methode alle in der destinationTimeZone Zeitzone geltenden Anpassungsregeln an.When performing the conversion, the ConvertTime(DateTimeOffset, TimeZoneInfo) method applies any adjustment rules in effect in the destinationTimeZone time zone.

Diese über ConvertTime(DateTime, TimeZoneInfo) Ladung der-Methode bestimmt die Quell Zeitzone aus dem Wert dateTime der-Eigenschaft des Kind -Parameters, wie in der folgenden Tabelle gezeigt.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-Eigenschafts WertKind property value Quell ZeitzoneSource time zone Methoden VerhaltenMethod behavior
DateTimeKind.Local Local Konvertiert die lokale Zeit in die Uhrzeit in destinationTimeZone.Converts the local time to the time in destinationTimeZone.
DateTimeKind.Utc Utc Konvertiert die koordinierte Weltzeit (UTC) in die Uhrzeit destinationTimeZonein.Converts Coordinated Universal Time (UTC) to the time in destinationTimeZone.
DateTimeKind.Unspecified Angenommen, Localist.Assumed to be Local. Konvertiert die lokale Zeit in die Uhrzeit in destinationTimeZone.Converts the local time to the time in destinationTimeZone.

Die Kind -Eigenschaft des zurück DateTime gegebenen Werts wird wie in der folgenden Tabelle dargestellt festgelegt.The Kind property of the returned DateTime value is set as shown in the following table.

BedingungCondition Zurückgegebener Kind-Eigenschafts WertReturned Kind property value
destinationTimeZone ist TimeZoneInfo.Utc.The destinationTimeZone is TimeZoneInfo.Utc. DateTimeKind.Utc
destinationTimeZone ist TimeZoneInfo.Local.The destinationTimeZone is TimeZoneInfo.Local. DateTimeKind.Local
Alle anderen Datums-und Uhrzeitwerte und Ziel Zeitzonen.All other date and time values and destination time zones. DateTimeKind.Unspecified

Wenn der Wert des dateTime -Parameters eine mehrdeutige Ortszeit ist, wird er als Standardzeit interpretiert.If the value of the dateTime parameter is an ambiguous local time, it is interpreted as a standard time. Wenn der dateTime -Parameter eine ungültige Ortszeit ist, löst diese Methode ArgumentExceptioneine aus.If the dateTime parameter is an invalid local time, this method throws an ArgumentException.

Wenn die Konvertierung von dateTime führt ein Datum und Uhrzeit-Wert, der älter als DateTime.MinValue oder später als DateTime.MaxValue, gibt diese Methode DateTime.MinValue oder DateTime.MaxValuebzw.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.

Sie können auch in oder aus UTC konvertieren, indem Sie ConvertTimeFromUtc die ConvertTimeToUtc -Methode und die-Methode aufrufen.You can also convert to or from UTC by calling the ConvertTimeFromUtc and ConvertTimeToUtc methods.

Siehe auch

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

Konvertiert eine Zeit in die Zeit in einer bestimmten Zeitzone.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

Parameter

dateTimeOffset
DateTimeOffset DateTimeOffset DateTimeOffset

Das Datum und die Uhrzeit, die konvertiert werden sollen.The date and time to convert.

destinationTimeZone
TimeZoneInfo TimeZoneInfo TimeZoneInfo

Die Zeitzone, in die dateTime konvertiert werden soll.The time zone to convert dateTime to.

Gibt zurück

Das Datum und die Uhrzeit in der Zielzeitzone.The date and time in the destination time zone.

Ausnahmen

Der Wert des destinationTimeZone-Parameters ist null.The value of the destinationTimeZone parameter is null.

Beispiele

Im folgenden Beispiel wird ein Array von DateTimeOffset -Werten in Zeiten in der Eastern Time Zone der USA und Kanada konvertiert.The following example converts an array of DateTimeOffset values to times in the Eastern Time zone of the U.S. and Canada. Es veranschaulicht, dass ConvertTime die-Methode Zeit Zonen Anpassungen berücksichtigt, da eine Zeit Zonen Anpassung in den Quell-und Ziel Zeitzonen um 2:00 Uhr stattfindet.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. am 7. November 2010.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.

Hinweise

Beim Durchführen der Konvertierung wendet ConvertTime(DateTimeOffset, TimeZoneInfo) die-Methode alle in der destinationTimeZone Zeitzone geltenden Anpassungsregeln an.When performing the conversion, the ConvertTime(DateTimeOffset, TimeZoneInfo) method applies any adjustment rules in effect in the destinationTimeZone time zone.

Diese Überladung unterscheidet sich von den anderen über ConvertTime Ladungen der-Methode DateTimeOffset , indem ein Wert als erster Parameter angenommen wird.This overload differs from the other overloads of the ConvertTime method by accepting a DateTimeOffset value as its first parameter. Dadurch wird das Datum und die Uhrzeit als Offset von der koordinierten Weltzeit (UTC) anstelle von Datum und Uhrzeit in einer bestimmten Zeitzone identifiziert.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. Folglich kann der dateTimeOffset -Parameter nicht entweder eine mehrdeutige Zeit oder eine ungültige Uhrzeit darstellen.As a result, the dateTimeOffset parameter cannot represent either an ambiguous time or an invalid time.

Bei der Umstellung dateTimeOffset des Werts in die Uhrzeit in der Ziel Zeitzone berücksichtigt diese Methode alle in der Ziel Zeitzone geltenden Anpassungsregeln.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.

Wenn die Konvertierung von dateTimeOffset führt ein Datum und Uhrzeit-Wert, der älter als DateTimeOffset.MinValue oder später als DateTimeOffset.MaxValue, gibt diese Methode DateTimeOffset.MinValue oder DateTimeOffset.MaxValuebzw.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.

Siehe auch

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

Konvertiert eine Zeit aus einer Zeitzone in ein andere.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

Parameter

dateTime
DateTime DateTime DateTime

Das Datum und die Uhrzeit, die konvertiert werden sollen.The date and time to convert.

sourceTimeZone
TimeZoneInfo TimeZoneInfo TimeZoneInfo

Die Zeitzone von dateTime.The time zone of dateTime.

destinationTimeZone
TimeZoneInfo TimeZoneInfo TimeZoneInfo

Die Zeitzone, in die dateTime konvertiert werden soll.The time zone to convert dateTime to.

Gibt zurück

Das Datum und die Uhrzeit in der Zielzeitzone, die dem dateTime-Parameter in der Quellzeitzone entsprechen.The date and time in the destination time zone that corresponds to the dateTime parameter in the source time zone.

Ausnahmen

Die Kind-Eigenschaft des dateTime-Parameters ist Local, aber der sourceTimeZone-Parameter entspricht nicht Local.The Kind property of the dateTime parameter is Local, but the sourceTimeZone parameter does not equal Local.

- oder --or- Die Kind-Eigenschaft des dateTime-Parameters ist Utc, aber der sourceTimeZone-Parameter entspricht nicht Utc.The Kind property of the dateTime parameter is Utc, but the sourceTimeZone parameter does not equal Utc.

- oder --or- Der dateTime-Parameter gibt eine ungültige Zeit an (d. h. er stellt eine Zeit dar, die aufgrund der Anpassungsregeln einer Zeitzone nicht vorhanden ist).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).

Der sourceTimeZone-Parameter ist null.The sourceTimeZone parameter is null.

- oder --or- Der destinationTimeZone-Parameter ist null.The destinationTimeZone parameter is null.

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung der- ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) Methode zum Konvertieren von der Hawaiisch Standard Zeit in die lokale Zeit.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                     

Hinweise

Beim Durchführen der Konvertierung wendet ConvertTime die-Methode alle in der destinationTimeZone Zeitzone geltenden Anpassungsregeln an.When performing the conversion, the ConvertTime method applies any adjustment rules in effect in the destinationTimeZone time zone.

Der Wert der Kind -Eigenschaft dateTime des-Parameters muss dem sourceTimeZone -Parameter entsprechen, wie in der folgenden Tabelle gezeigt.The value of the Kind property of the dateTime parameter must correspond to the sourceTimeZone parameter, as the following table shows.

DateTime. Kind-WertDateTime.Kind value sourceTimeZone-WertsourceTimeZone value Methoden VerhaltenMethod behavior
DateTimeKind.Utc Ist TimeZoneInfo.UtcGleichheits.Equals TimeZoneInfo.Utc. Konvertiert dateTime in die Zeit der Ziel Zeitzone.Converts dateTime to the destination time zone's time.
DateTimeKind.Utc Does not equal TimeZoneInfo.Utc.Does not equal TimeZoneInfo.Utc. Löst eine ArgumentExceptionaus.Throws an ArgumentException.
DateTimeKind.Local Ist TimeZoneInfo.LocalGleichheits.Equals TimeZoneInfo.Local. Konvertiert dateTime in die Zeit der Ziel Zeitzone.Converts dateTime to the destination time zone's time.
DateTimeKind.Local Does not equal TimeZoneInfo.Local.Does not equal TimeZoneInfo.Local. Löst eine ArgumentExceptionaus.Throws an ArgumentException.
DateTimeKind.Unspecified Irgendeiner.Any. Konvertiert dateTime in die Zeit der Ziel Zeitzone.Converts dateTime to the destination time zone's time.

Sie können auch in oder aus der koordinierten Weltzeit (UTC) konvertieren, indem ConvertTimeFromUtc Sie ConvertTimeToUtc die-Methode und die-Methode aufrufen.You can also convert to or from Coordinated Universal Time (UTC) by calling the ConvertTimeFromUtc and ConvertTimeToUtc methods.

Die Kind -Eigenschaft des zurück DateTime gegebenen Werts wird wie in der folgenden Tabelle dargestellt festgelegt.The Kind property of the returned DateTime value is set as shown in the following table.

BedingungCondition Zurückgegebener Kind-Eigenschafts WertReturned Kind property value
Das destinationTimeZone-Argument lautet TimeZoneInfo.Utc.The destinationTimeZone argument is TimeZoneInfo.Utc. DateTimeKind.Utc
Das destinationTimeZone-Argument lautet TimeZoneInfo.Local.The destinationTimeZone argument is TimeZoneInfo.Local. DateTimeKind.Local
Alle anderen Datums-und Uhrzeitwerte, Quell Zeitzonen und Ziel Zeitzonen.All other date and time values, source time zones, and destination time zones. DateTimeKind.Unspecified

Wenn der Wert des dateTime -Parameters eine mehrdeutige Zeit in der Quell Zeitzone ist, wird er als Standardzeit interpretiert.If the value of the dateTime parameter is an ambiguous time in the source time zone, it is interpreted as a standard time. Wenn der dateTime -Parameter eine ungültige Zeit in der Quell Zeitzone ist, löst diese Methode ArgumentExceptioneine aus.If the dateTime parameter is an invalid time in the source time zone, this method throws an ArgumentException.

Wenn die Konvertierung von dateTime führt ein Datum und Uhrzeit-Wert, der älter als DateTime.MinValue oder später als DateTime.MaxValue, gibt diese Methode DateTime.MinValue oder DateTime.MaxValuebzw.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.

Die ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) -Methode löst ArgumentException eine Ausnahme aus DateTime.Kind , dateTime wenn die-Eigenschaft DateTimeKind.Local des- sourceTimeZone Arguments ist, TimeZoneInfo.Localaber das-Argument nicht ist.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. Um zu ermitteln, ob es sich bei der Quell Zeitzone um die lokale Zeitzone oder die universelle Zeitzone handelt, testet die Methode auf Verweis Gleichheit, anstatt auf Wert Equals(TimeZoneInfo) Gleichheit mit der-Methode zu testen.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. Beachten Sie TimeZoneInfo , dass-Objekte, die die lokale Zeitzone darstellen und durch Aufrufen der FindSystemTimeZoneById -Methode abgerufen werden, nicht über die TimeZoneInfo.Localreferenzielle Gleichheit mit verfügen.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. Außerdem verfügen GetSystemTimeZones TimeZoneInfo.Local TimeZoneInfo.UtcObjekte, die die lokale oder universelle Zeitzone darstellen und durch Iteration der von der-Methode zurückgegebenen Auflistung abgerufen werden, nicht über die referenzielle Gleichheit mit oder. TimeZoneInfoFurthermore, 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. Als Alternative können Sie die ConvertTimeBySystemTimeZoneId(DateTime, String, String) -Methode aufzurufen.As an alternative, you can call the ConvertTimeBySystemTimeZoneId(DateTime, String, String) method.

Siehe auch

Gilt für: