DateTimeOffset-Struktur

Die DateTimeOffset-Struktur schließt einen DateTime-Wert zusammen mit einer Offset-Eigenschaft ein, die den Unterschied zwischen dem Datum und der Uhrzeit der aktuellen DateTimeOffset-Instanz und der Coordinated Universal Time (UTC) definiert. Da die DateTimeOffset-Struktur ein Datum und eine Uhrzeit relativ zur UTC genau definiert, beinhaltet sie im Unterschied zur DateTime-Struktur keinen Kind-Member. Sie stellt Datums- und Uhrzeitangaben mit Werten dar, deren UTC zwischen 00:00:00 Uhr, 1. Januar 0001 u. Z., bis 23:59:59, 31. Dezember 9999 u. Z. liegt. (unsere Zeitrechnung)

Die Zeitkomponente eines DateTimeOffset-Werts wird in 100-Nanosekunden-Einheiten gemessen, die als Ticks bezeichnet werden. Ein bestimmtes Datum ist die Anzahl Ticks seit dem 1.Januar 0001, 12:12:12 u. Z. (u. Z.) im GregorianCalendar-Kalender. Ein DateTimeOffset-Wert bezieht sich immer auf den Kontext eines expliziten Kalenders oder eines Standardkalenders. Teilstriche, die Schaltsekunden zuzuordnen sind, sind nicht in der Gesamtzahl der Teilstriche enthalten.

Hinweis

Wenn Sie mit einem Teilstriche-Wert arbeiten, den Sie in ein anderes Zeitintervall, z. B. Minuten oder Sekunden, konvertieren möchten, sollten Sie den TimeSpan.TicksPerDay verwenden oder die TimeSpan.TicksPerHour-Konstante, die TimeSpan.TicksPerMinute-Konstante, die TimeSpan.TicksPerSecond-Konstante oder TimeSpan.TicksPerMillisecond-Konstante, um die Konvertierung auszuführen. Sie können die Anzahl der Sekunden, die durch eine angegebene Anzahl von Teilstrichen zur Second-Komponente eines DateTimeOffset-Werts dargestellt wurde, mithilfe des Ausdrucks dateValue.Second + nTicks/Timespan.TicksPerSecond hinzufügen.

Ein DateTimeOffset-Wert schließt zwar einen Offset ein, ist jedoch keine Datenstruktur, die Zeitzonen vollständig unterstützt. Ein UTC-Offset ist ein Merkmal einer Zeitzone, identifiziert eine Zeitzone aber nicht eindeutig. Mehrere Zeitzonen nutzen nicht nur denselben UTC-Offset gemeinsam, sondern der Offset einer einzelnen Zeitzone ändert sich auch, wenn die Sommerzeit berücksichtigt wird. Das bedeutet, dass beim Aufheben der Zuweisung eines DateTimeOffset-Werts zur zugehörigen Zeitzone dieser Wert nicht mehr eindeutig mit der ursprünglichen Zeitzone verknüpft werden kann.

Da es sich bei DateTimeOffset um eine Struktur handelt, enthält ein DateTimeOffset-Objekt, das zwar deklariert, aber nicht anderweitig initialisiert wurde, die Standardwerte für die einzelnen Memberfelder. Dies bedeutet, dass die zugehörige DateTime-Eigenschaft auf DateTimeOffset.MinValue und die Offset-Eigenschaft auf TimeSpan.Zero festgelegt sind.

Sie können einen neuen DateTimeOffset-Wert erstellen, indem Sie eine der Überladungen des Konstruktors aufrufen, die den überladenen Konstruktoren für die DateTime-Struktur ähneln. Außerdem können Sie einen neuen DateTimeOffset-Wert erstellen, indem Sie ihm einen DateTime-Wert zuweisen. Dies ist eine implizite Konvertierung, für die kein Umwandlungsoperator (in C#) bzw. kein Aufruf einer Konvertierungsmethode (in Visual Basic) erforderlich ist. Sie können auch einen DateTimeOffset-Wert aus der Zeichenfolgendarstellung eines Datums und einer Uhrzeit initialisieren, indem Sie eine Reihe statischer Methoden zur Zeichenfolgenanalyse aufrufen, u. a. Parse, ParseExact, TryParse und TryParseExact.

Die Member der DateTimeOffset-Struktur stellen Funktionen in den folgenden Bereichen bereit:

• Arithmetische Datums- und Uhrzeitoperationen.

  Sie können Datumsangaben oder Zeitintervalle zu einem bestimmten DateTimeOffset-Wert addieren oder von diesem subtrahieren. Bei arithmetischen Operationen mit DateTimeOffset-Werten werden anders als bei solchen mit DateTime-Werten Unterschiede in Zeitoffsets bei der Rückgabe von Werten berücksichtigt. Beispielsweise werden im folgenden Code DateTime-Variablen verwendet, um die aktuelle Ortszeit von der aktuellen UTC-Zeit zu subtrahieren. Im Code werden dann DateTimeOffset-Variablen verwendet, um dieselbe Operation auszuführen. Die Subtraktion mit DateTime-Werten gibt die Differenz zwischen der lokalen Zeitzone und der UTC zurück, während die Subtraktion mit DateTimeOffset-Werten TimeSpan.Zero zurückgibt.

  C#

  VB

  Kopieren

  
  using System;
  
  public class DateArithmetic
  {
     public static void Main()
     {
        DateTime date1, date2;
        DateTimeOffset dateOffset1, dateOffset2;
        TimeSpan difference;
  
        // Find difference between Date.Now and Date.UtcNow
        date1 = DateTime.Now;
        date2 = DateTime.UtcNow;
        difference = date1 - date2;
        Console.WriteLine("{0} - {1} = {2}", date1, date2, difference);
  
        // Find difference between Now and UtcNow using DateTimeOffset
        dateOffset1 = DateTimeOffset.Now;
        dateOffset2 = DateTimeOffset.UtcNow;
        difference = dateOffset1 - dateOffset2;
        Console.WriteLine("{0} - {1} = {2}", 
                          dateOffset1, dateOffset2, difference);
        // If run in the Pacific Standard time zone on 4/2/2007, the example
        // displays the following output to the console:
        //    4/2/2007 7:23:57 PM - 4/3/2007 2:23:57 AM = -07:00:00
        //    4/2/2007 7:23:57 PM -07:00 - 4/3/2007 2:23:57 AM +00:00 = 00:00:00                        
     }
  }
  
  
  

• Typkonvertierungsoperationen.

  Sie können DateTimeOffset-Werte in DateTime-Werte konvertieren und umgekehrt.

• Änderungs- und Extraktionsvorgänge für Zeitangaben.

  Sie können entweder das Datum oder die Uhrzeit eines DateTimeOffset-Werts extrahieren. Darüber hinaus können Sie den Wert einer bestimmten DateTimeOffset-Komponente abrufen, z. B. das Jahr oder den Monat.

• Konvertierung von Datum und Uhrzeit.

  Sie können jeden DateTimeOffset-Wert in einen anderen DateTimeOffset-Wert konvertieren, der denselben Zeitpunkt in einer anderen Zeitzone darstellt. Die Anpassungsregeln einer Zeitzone werden aber nur bei der ToLocalTime-Methode angewendet, die einen DateTimeOffset-Wert in das Datum und die Uhrzeit in der lokalen Systemzeit konvertiert.

• Vergleich von Datum und Uhrzeit.

  Sie können festlegen, ob ein bestimmter DateTimeOffset-Wert vor oder nach einem anderen DateTimeOffset-Wert liegt oder mit diesem identisch ist. Vor Durchführung des Vergleichs werden alle Werte in UTC konvertiert.

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz

Weitere Ressourcen