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 folgende Beispiel konvertiert ein Array von Datums-und Uhrzeitwerte in Zeiten, in der Zeitzone Eastern für die USA und Kanada.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 Quellzeitzone hängt die DateTime.Kind Eigenschaft der Quelle der DateTime Wert.It shows that the source time zone depends on the DateTime.Kind property of the source DateTime value. Es veranschaulicht auch, dass die ConvertTime Methode nimmt zeitzonenanpassungen berücksichtigt, da die Anpassung der Zeitzone in der Quell- und Zielservern Zeitzonen um 2:00 Uhr auftrittIt 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. auf dem 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, die ConvertTime(DateTimeOffset, TimeZoneInfo) -Methode angewendet wird, alle Anpassungsregeln wirksam in der destinationTimeZone Zeitzone.When performing the conversion, the ConvertTime(DateTimeOffset, TimeZoneInfo) method applies any adjustment rules in effect in the destinationTimeZone time zone.

Diese Überladung von der ConvertTime(DateTime, TimeZoneInfo) Methode bestimmt der Quellzeitzone aus dem Wert der dateTime des Parameters Kind Eigenschaft, wie die folgende Tabelle zeigt.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-Eigenschaft-WertKind property value QuellzeitzoneSource time zone MethodenverhaltenMethod behavior
DateTimeKind.Local Local Konvertiert die lokale Zeit in die Zeit in destinationTimeZone.Converts the local time to the time in destinationTimeZone.
DateTimeKind.Utc Utc Konvertiert Sie in die Uhrzeit in Coordinated Universal Time (UTC) destinationTimeZone.Converts Coordinated Universal Time (UTC) to the time in destinationTimeZone.
DateTimeKind.Unspecified Davon ausgegangen, dass Local.Assumed to be Local. Konvertiert die lokale Zeit in die Zeit in destinationTimeZone.Converts the local time to the time in destinationTimeZone.

Die Kind -Eigenschaft des zurückgegebenen DateTime Wert wird festgelegt, wie in der folgenden Tabelle gezeigt.The Kind property of the returned DateTime value is set as shown in the following table.

BedingungCondition Kind-Eigenschaft-Wert zurückgegebenReturned 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 der dateTime -Parameter einer mehrdeutigen 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 die dateTime -Parameter ist eine ungültige lokale Zeit, löst diese Methode eine ArgumentException.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 die zu oder von UTC konvertieren, durch den Aufruf der ConvertTimeFromUtc und ConvertTimeToUtc Methoden.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 Zeitzone Eastern für die USA und Kanada.The following example converts an array of DateTimeOffset values to times in the Eastern Time zone of the U.S. and Canada. Zeigt, dass die ConvertTime Methode nimmt zeitzonenanpassungen berücksichtigt, da die Anpassung der Zeitzone in der Quell- und Zielservern Zeitzonen um 2:00 Uhr auftrittIt 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. auf dem 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, die ConvertTime(DateTimeOffset, TimeZoneInfo) -Methode angewendet wird, alle Anpassungsregeln wirksam in der destinationTimeZone Zeitzone.When performing the conversion, the ConvertTime(DateTimeOffset, TimeZoneInfo) method applies any adjustment rules in effect in the destinationTimeZone time zone.

Diese Überladung, die von der anderen Überladungen der unterscheidet sich die ConvertTime Methode durch das Akzeptieren einer DateTimeOffset Wert als ersten Parameter.This overload differs from the other overloads of the ConvertTime method by accepting a DateTimeOffset value as its first parameter. Dies gibt Datum und Uhrzeit, als ein Offset von Coordinated Universal Time (UTC) und nicht als Datum und Uhrzeit in einer bestimmten Zeitzone.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. Daher die dateTimeOffset Parameter kann nicht entweder eine mehrdeutige Zeit oder eine ungültige Zeit darstellt.As a result, the dateTimeOffset parameter cannot represent either an ambiguous time or an invalid time.

Bei der Konvertierung der dateTimeOffset Wert, der die Zeit in der Zielzeitzone, die diese Methode berücksichtigt Anpassungsregeln in der Zielzeitzone.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, um aus der Hawaiian Standard Time in die lokale Zeit zu konvertieren.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, die ConvertTime -Methode angewendet wird, alle Anpassungsregeln wirksam in der destinationTimeZone Zeitzone.When performing the conversion, the ConvertTime method applies any adjustment rules in effect in the destinationTimeZone time zone.

Der Wert des der Kind Eigenschaft der dateTime Parameter muss entsprechen, die die sourceTimeZone Parameters, wie die folgende Tabelle zeigt.The value of the Kind property of the dateTime parameter must correspond to the sourceTimeZone parameter, as the following table shows.

DateTime.Kind valueDateTime.Kind value SourceTimeZone WertsourceTimeZone value MethodenverhaltenMethod behavior
DateTimeKind.Utc Ist gleich TimeZoneInfo.Utc.Equals TimeZoneInfo.Utc. Konvertiert dateTime auf das Ziel der Zeitzone.Converts dateTime to the destination time zone's time.
DateTimeKind.Utc Ist nicht gleich TimeZoneInfo.Utc.Does not equal TimeZoneInfo.Utc. Löst ein ArgumentException.Throws an ArgumentException.
DateTimeKind.Local Ist gleich TimeZoneInfo.Local.Equals TimeZoneInfo.Local. Konvertiert dateTime auf das Ziel der Zeitzone.Converts dateTime to the destination time zone's time.
DateTimeKind.Local Ist nicht gleich TimeZoneInfo.Local.Does not equal TimeZoneInfo.Local. Löst ein ArgumentException.Throws an ArgumentException.
DateTimeKind.Unspecified Alle.Any. Konvertiert dateTime auf das Ziel der Zeitzone.Converts dateTime to the destination time zone's time.

Sie können auch die zu oder von der koordinierten Weltzeit (UTC) konvertieren, durch den Aufruf der ConvertTimeFromUtc und ConvertTimeToUtc Methoden.You can also convert to or from Coordinated Universal Time (UTC) by calling the ConvertTimeFromUtc and ConvertTimeToUtc methods.

Die Kind -Eigenschaft des zurückgegebenen DateTime Wert wird festgelegt, wie in der folgenden Tabelle gezeigt.The Kind property of the returned DateTime value is set as shown in the following table.

BedingungCondition Kind-Eigenschaft-Wert zurückgegebenReturned 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 Time-Werten, Zeitzonen für die Quelle und Zielzeitzonen.All other date and time values, source time zones, and destination time zones. DateTimeKind.Unspecified

Wenn der Wert des der dateTime -Parameter ist eine mehrdeutige Zeit in der Quellzeitzone, 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 die dateTime -Parameter ist eine ungültige Zeit in der Quellzeitzone, löst diese Methode eine ArgumentException.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 eine ArgumentException Ausnahme wenn die DateTime.Kind Eigenschaft der dateTime Argument ist DateTimeKind.Local jedoch sourceTimeZone Argument ist kein 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. Um zu bestimmen, ob der Quellzeitzone der lokalen Zeitzone oder der Coordinated Universal Time Zone ist, testet die Methode hinsichtlich der Verweisgleichheit statt Testen auf Gleichheit Wert mit dem Equals(TimeZoneInfo) Methode.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, dass TimeZoneInfo Objekte, die die lokale Zeitzone darstellen, die durch den Aufruf abgerufen werden, und wählen Sie, die FindSystemTimeZoneById Methode keine Verweisgleichheit verglichen mit 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. Darüber hinaus TimeZoneInfo -Objekte, die der lokale oder der Coordinated Universal Time Zone darstellen und, werden abgerufen, indem das Durchlaufen der Auflistung zurückgegeben werden, indem, die GetSystemTimeZones Methode keine Verweisgleichheit verglichen mit TimeZoneInfo.Local oder 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. Als Alternative können Sie erreichen die ConvertTimeBySystemTimeZoneId(DateTime, String, String) Methode.As an alternative, you can call the ConvertTimeBySystemTimeZoneId(DateTime, String, String) method.

Siehe auch

Gilt für: