DateTimeOffset.ToLocalTime Methode

Definition

Konvertiert das aktuelle DateTimeOffset-Objekt in ein DateTimeOffset-Objekt, das die Ortszeit darstellt.

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

Gibt zurück

DateTimeOffset

Ein Objekt, das die in Ortszeit konvertierte Datums- und Uhrzeitangabe des aktuellen DateTimeOffset-Objekts darstellt.

Beispiele

Im folgenden Beispiel wird die -Methode verwendet, um einen Wert in die Lokale Zeit ToLocalTime in der Pacific Standard Time Zone zu DateTimeOffset konvertieren. Außerdem wird die Unterstützung der -Methode für die Anpassungsregeln der lokalen Zeitzone veranschaulicht.

// 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

Bei der Konvertierung in die lokale Zeit konvertiert die -Methode zuerst das Datum und die Uhrzeit des aktuellen Objekts in koordinierte Weltzeit (UTC), indem der Offset von der Zeit subtrahiert DateTimeOffset wird. Anschließend werden UTC-Datum und -Uhrzeit durch Hinzufügen des lokalen Zeitzonenoffsets in lokale Uhrzeit konvertiert. Dabei werden alle Anpassungsregeln für die lokale Zeitzone berücksichtigt.

Sowohl der Wert des aktuellen Objekts als auch der Wert des vom Methodenaufruf zurückgegebenen Objekts DateTimeOffset DateTimeOffset stellen denselben Zeitpunkt dar. Das heißt, wenn beide an die -Methode übergeben DateTimeOffset.Equals(DateTimeOffset, DateTimeOffset) werden, gibt die -Methode true zurück.

Wenn die Konvertierung eine Zeit verursacht, die nicht im Bereich des Typs liegt, gibt die Methode ein -Objekt zurück, bei dem das Datum und die Uhrzeit entweder auf oder und der Offset auf den lokalen Zeitzonenoffset DateTimeOffset ToLocalTime festgelegt DateTimeOffset MaxValue MinValue ist.

Gilt für

Siehe auch