DateTimeOffset.ToLocalTime DateTimeOffset.ToLocalTime DateTimeOffset.ToLocalTime DateTimeOffset.ToLocalTime Method

Definition

Konvertiert das aktuelle DateTimeOffset-Objekt in ein DateTimeOffset-Objekt, das die Ortszeit darstellt.Converts the current DateTimeOffset object to a DateTimeOffset object that represents the local time.

public:
 DateTimeOffset ToLocalTime();
public DateTimeOffset ToLocalTime ();
member this.ToLocalTime : unit -> DateTimeOffset
Public Function ToLocalTime () As DateTimeOffset

Gibt zurück

Ein Objekt, das die in Ortszeit konvertierte Datums- und Uhrzeitangabe des aktuellen DateTimeOffset-Objekts darstellt.An object that represents the date and time of the current DateTimeOffset object converted to local time.

Beispiele

Im folgenden Beispiel wird die ToLocalTime -Methode verwendet, DateTimeOffset um einen Wert in die lokale Zeit in der Pacific Standard Time-Zone zu konvertieren.The following example uses the ToLocalTime method to convert a DateTimeOffset value to local time in the Pacific Standard Time zone. Außerdem wird die Unterstützung der Methode für die Anpassungsregeln der lokalen Zeitzone veranschaulicht.It also illustrates the method's support for the local time zone's adjustment rules.

// Local time changes on 3/11/2007 at 2:00 AM
DateTimeOffset originalTime, localTime;

originalTime = new DateTimeOffset(2007, 3, 11, 3, 0, 0, 
                                  new TimeSpan(-6, 0, 0));
localTime = originalTime.ToLocalTime();
Console.WriteLine("Converted {0} to {1}.", originalTime.ToString(), 
                                           localTime.ToString());   

originalTime = new DateTimeOffset(2007, 3, 11, 4, 0, 0, 
                                  new TimeSpan(-6, 0, 0));
localTime = originalTime.ToLocalTime();
Console.WriteLine("Converted {0} to {1}.", originalTime.ToString(), 
                                           localTime.ToString());    

// Define a summer UTC time
originalTime = new DateTimeOffset(2007, 6, 15, 8, 0, 0, 
                                  TimeSpan.Zero);
localTime = originalTime.ToLocalTime();
Console.WriteLine("Converted {0} to {1}.", originalTime.ToString(),
                                           localTime.ToString());    

// Define a winter time
originalTime = new DateTimeOffset(2007, 11, 30, 14, 0, 0, 
                                  new TimeSpan(3, 0, 0));
localTime = originalTime.ToLocalTime();
Console.WriteLine("Converted {0} to {1}.", originalTime.ToString(), 
                                           localTime.ToString());
// The example produces the following output:
//    Converted 3/11/2007 3:00:00 AM -06:00 to 3/11/2007 1:00:00 AM -08:00.
//    Converted 3/11/2007 4:00:00 AM -06:00 to 3/11/2007 3:00:00 AM -07:00.
//    Converted 6/15/2007 8:00:00 AM +00:00 to 6/15/2007 1:00:00 AM -07:00.
//    Converted 11/30/2007 2:00:00 PM +03:00 to 11/30/2007 3:00:00 AM -08:00.                                                           
' Local time changes on 3/11/2007 at 2:00 AM
Dim originalTime, localTime As DateTimeOffset

originalTime = New DateTimeOffset(#03/11/2007 3:00AM#, _
                                  New TimeSpan(-6, 0, 0))
localTime = originalTime.ToLocalTime()
Console.WriteLine("Converted {0} to {1}.", originalTime.ToString(), _
                                           localTime.ToString())       

originalTime = New DateTimeOffset(#03/11/2007 4:00AM#, _
                                  New TimeSpan(-6, 0, 0))
localTime = originalTime.ToLocalTime()
Console.WriteLine("Converted {0} to {1}.", originalTime.ToString(), _
                                           localTime.ToString())       

' Define a summer UTC time
originalTime = New DateTimeOffset(#6/15/2007 8:00AM#, _
                                  TimeSpan.Zero)
localTime = originalTime.ToLocalTime()
Console.WriteLine("Converted {0} to {1}.", originalTime.ToString(), _
                                           localTime.ToString())       

' Define a winter time
originalTime = New DateTimeOffset(#11/30/2007 2:00PM#, _
                                  New TimeSpan(3, 0, 0))
localTime = originalTime.ToLocalTime()
Console.WriteLine("Converted {0} to {1}.", originalTime.ToString(), _
                                           localTime.ToString())   
' The example produces the following output:
'    Converted 3/11/2007 3:00:00 AM -06:00 to 3/11/2007 1:00:00 AM -08:00.
'    Converted 3/11/2007 4:00:00 AM -06:00 to 3/11/2007 3:00:00 AM -07:00.
'    Converted 6/15/2007 8:00:00 AM +00:00 to 6/15/2007 1:00:00 AM -07:00.
'    Converted 11/30/2007 2:00:00 PM +03:00 to 11/30/2007 3:00:00 AM -08:00.                                                           

Hinweise

Beim Durchführen der Konvertierung in die Ortszeit konvertiert die-Methode zuerst das DateTimeOffset Datum und die Uhrzeit des aktuellen-Objekts in die koordinierte Weltzeit (UTC), indem der Offset von der Zeit subtrahieren wird.In performing the conversion to local time, the method first converts the current DateTimeOffset object's date and time to Coordinated Universal Time (UTC) by subtracting the offset from the time. Anschließend wird das UTC-Datum und die UTC-Zeit in die Ortszeit konvertiert, indem der lokale Zeit Zonen Offset hinzugefügt wird.It then converts the UTC date and time to local time by adding the local time zone offset. Dabei werden alle Anpassungsregeln für die lokale Zeitzone berücksichtigt.In doing this, it takes account of any adjustment rules for the local time zone.

Sowohl der Wert des aktuellen DateTimeOffset -Objekts als auch der Wert DateTimeOffset des-Objekts, das vom-Methodenaufruf zurückgegeben wird, stellen denselben Zeitpunkt dar.Both the value of the current DateTimeOffset object and the value of the DateTimeOffset object returned by the method call represent the same point in time. Das heißt, wenn beide an die DateTimeOffset.Equals(DateTimeOffset, DateTimeOffset) -Methode übermittelt werden, gibt die Methode zurück. trueThat is, if both are passed to the DateTimeOffset.Equals(DateTimeOffset, DateTimeOffset) method, the method will return true.

Wenn die Konvertierung eine Zeit verursacht, die außerhalb des DateTimeOffset zulässigen Bereichs liegt, gibt die ToLocalTime -Methode ein DateTimeOffset -Objekt zurück, dessen Datum und Uhrzeit entweder MaxValue auf oder MinValue festgelegt sind und der Offset auf den lokalen Zeit Zonen Offset festgelegt ist.If the conversion causes a time that is out of range of the DateTimeOffset type, the ToLocalTime method returns a DateTimeOffset object that has the date and time set to either MaxValue or MinValue and the offset set to the local time zone offset.

Gilt für:

Siehe auch