DateTime-Struktur

Sie verfügen über folgende Möglichkeiten, um einen neuen DateTime-Wert zu erstellen:

• Durch das Aufrufen einer der Überladungen des DateTime-Konstruktors, die das Angeben spezifischer Elemente des Datums- und Uhrzeitwerts (wie Jahr, Monat und Tag oder Anzahl der Ticks) ermöglichen. Die folgende Anweisung veranschaulicht einen Aufruf eines der DateTime-Konstruktoren, um ein Datum mit den spezifischen Angaben für Jahr, Monat, Tag, Stunde, Minute und Sekunde zu erstellen.

  C#

  VB

  Kopieren

  
  DateTime date1 = new DateTime(2008, 5, 1, 8, 30, 52);
  
  
  

• Durch das Verwenden einer compilerspezifischen Syntax zum Deklarieren von Datums- und Uhrzeitwerten. Durch die folgende Visual Basic-Anweisung wird z. B. ein neuer DateTime-Wert initialisiert.

  VB

  Kopieren

  
  Dim date1 As Date = #5/1/2008 8:30:52AM#
  
  
  

• Durch das Zuweisen eines Datums- und Uhrzeitwerts zum DateTime-Objekt, der von einer Eigenschaft oder einer Methode zurückgegeben wurde. Im folgenden Beispiel werden drei neuen DateTime-Variablen das aktuelle Datum und die aktuelle Uhrzeit, die aktuellen UTC-Werte (Coordinated Universal Time) für Datum und Uhrzeit sowie das aktuelle Datum zugewiesen.

  C#

  VB

  Kopieren

  
  DateTime date1 = DateTime.Now;
  DateTime date2 = DateTime.UtcNow;
  DateTime date3 = DateTime.Today;
  
  
  

• Durch das Analysieren der Zeichenfolgendarstellung eines Datums- und Uhrzeitwerts. Die Methoden Parse, ParseExact, TryParse und TryParseExact konvertieren eine Zeichenfolge in ihren entsprechenden Datums- und Uhrzeitwert. Im folgenden Beispiel wird mit der Parse-Methode eine Zeichenfolge analysiert und in einen DateTime-Wert konvertiert.

  C#

  VB

  Kopieren

  
  string dateString = "5/1/2008 8:30:52 AM";
  DateTime date1 = DateTime.Parse(dateString, 
                            System.Globalization.CultureInfo.InvariantCulture); 
  
  
  

  Beachten Sie, dass die Methoden TryParse und TryParseExact zusätzlich zum Durchführen der Konvertierung angeben, ob eine bestimmte Zeichenfolge eine gültige Darstellung eines DateTime-Werts enthält.

• Durch das Aufrufen des impliziten Standardkonstruktors der DateTime-Struktur. (Einzelheiten zum impliziten Standardkonstruktor eines Werttyps finden Sie unter Werttypen (C#-Referenz).) Eine ungefähre Entsprechung für Compiler, die dies unterstützen, deklariert einen DateTime-Wert, ohne dass diesem explizit ein Datums- und Uhrzeitwert zugewiesen wird. Im folgenden Beispiel werden ein Aufruf des impliziten DateTime-Standardkonstruktors in C# und Visual Basic sowie eine DateTime-Variablendeklaration ohne Zuweisung in Visual Basic veranschaulicht.

  C#

  VB

  Kopieren

  
  DateTime dat1 = new DateTime();
  // The following method call displays 1/1/0001 12:00:00 AM.
  Console.WriteLine(dat1.ToString(System.Globalization.CultureInfo.InvariantCulture));
  // The following method call displays True.
  Console.WriteLine(dat1.Equals(DateTime.MinValue));
  
  
  

Intern werden alle DateTime-Werte als Anzahl von Ticks (Anzahl von 100-Nanosekunden-Intervallen) dargestellt, die seit 12:00:00 (Mitternacht), 1. Januar, 0001 verstrichen sind. Der tatsächliche DateTime-Wert ist beim Anzeigen in einem Benutzeroberflächenelement oder beim Schreiben in einer Datei unabhängig von der Methode, in der dieser Wert angezeigt wird. Die Darstellung eines DateTime-Werts ist das Ergebnis eines Formatierungsvorgangs. Beim Formatieren wird ein Wert in seine Zeichenfolgendarstellung konvertiert.

Da die Darstellung von Datum und Uhrzeit von Faktoren wie der Kultur, internationalen Standards, Anwendungsanforderungen und persönlichen Einstellungen abhängt, bietet die DateTime-Struktur beim Formatieren von Datums- und Uhrzeitwerten mit den Überladungen ihrer ToString-Methode ein hohes Maß an Flexibilität. Die standardmäßige DateTime.ToString()-Methode gibt die Zeichenfolgendarstellung eines Datums- und Uhrzeitwerts mit dem Datum im Kurzformat und der Uhrzeit im Langformat der aktuellen Kultur zurück. Im folgenden Beispiel werden mit der standardmäßigen DateTime.ToString()-Methode Datum und Uhrzeit im kurzen Datumsformat und im langen Uhrzeitformat für die Kultur en-US angezeigt, der aktuellen Kultur auf dem Computer, auf dem das Beispiel ausgeführt wurde.

DateTime date1 = new DateTime(2008, 3, 1, 7, 0, 0);
Console.WriteLine(date1.ToString());
// For en-US culture, displays 3/1/2008 7:00:00 AM

Die DateTime.ToString(IFormatProvider)-Methode gibt die Zeichenfolgendarstellung eines Datums- und Uhrzeitwerts mit dem kurzen Datumsformat und dem langen Uhrzeitformat einer bestimmten Kultur zurück. Im folgenden Beispiel werden mit der DateTime.ToString(IFormatProvider)-Methode Datum und Uhrzeit mit dem kurzen Datumsformat und dem langen Uhrzeitformat für die Kultur fr-FR angezeigt.

DateTime date1 = new DateTime(2008, 3, 1, 7, 0, 0);
Console.WriteLine(date1.ToString(System.Globalization.CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays 01/03/2008 07:00:00

Die DateTime.ToString(String)-Methode gibt die Zeichenfolgendarstellung des Datums und der Uhrzeit in einem Format zurück, das von einem standardmäßigen oder benutzerdefinierten Formatbezeichner und mithilfe der Formatierungskonventionen der aktuellen Kultur definiert wird. Im folgenden Beispiel wird mit der DateTime.ToString(String)-Methode das vollständige Datums- und Uhrzeitmuster für die Kultur en-US angezeigt, der aktuellen Kultur auf dem Computer, auf dem das Beispiel ausgeführt wurde.

DateTime date1 = new DateTime(2008, 3, 1, 7, 0, 0);
Console.WriteLine(date1.ToString("F"));
// Displays Saturday, March 01, 2008 7:00:00 AM

Die DateTime.ToString(String, IFormatProvider)-Methode gibt die Zeichenfolgendarstellung des Datums und der Uhrzeit in einem Format zurück, das von einem spezifischen Formatbezeichner und mithilfe der Formatierungskonventionen einer spezifischen Kultur definiert wird. Im folgenden Beispiel wird mit der DateTime.ToString(String, IFormatProvider)-Methode das vollständige Datums- und Uhrzeitmuster für die Kultur fr-FR angezeigt.

DateTime date1 = new DateTime(2008, 3, 1, 7, 0, 0);
Console.WriteLine(date1.ToString("F", new System.Globalization.CultureInfo("fr-FR")));
// Displays samedi 1 mars 2008 07:00:00

Vor .NET Framework, Version 2.0, enthält die DateTime-Struktur ein 64-Bit-Feld, das aus einem nicht verwendeten 2-Bit-Feld und einem privaten Ticks-Feld zusammengesetzt ist. Letzteres ist ein 62-Bit-Feld ohne Vorzeichen, das die Anzahl von Ticks zum Darstellen des Datums und der Uhrzeit enthält. Der Wert des Ticks-Felds kann mit der Ticks-Eigenschaft abgerufen werden.

Ab .NET Framework 2.0 enthält die DateTime-Struktur ein 64-Bit-Feld, das aus einem privaten Kind-Feld und dem Ticks-Feld zusammengesetzt ist. Das Kind-Feld ist ein 2-Bit-Feld, das angibt, ob die DateTime-Struktur eine Ortszeit, eine UTC-Zeit (Coordinated Universal Time) oder die Zeit in einer nicht angegebenen Zeitzone darstellt. Das Kind-Feld wird verwendet, um Konvertierungen zwischen Zeitzonen auszuführen, nicht jedoch für Vergleichs- und Arithmetikoperationen mit Zeitwerten. Der Wert des Kind-Felds kann mit der Kind-Eigenschaft abgerufen werden.

Hinweis

Eine Alternative zur DateTime-Struktur zum Arbeiten mit Datums- und Zeitwerten in bestimmten Zeitzonen ist die DateTimeOffset-Struktur. Die DateTimeOffset-Struktur speichert Datums- und Zeitinformationen in einem privaten DateTime-Feld sowie die Anzahl der Minuten, um die ein Datum und eine Uhrzeit von UTC abweicht, in einem privaten Int16-Feld. So kann ein DateTimeOffset-Wert die Zeit in einer bestimmten Zeitzone darstellen, während ein DateTime-Wert nur UTC und die Zeit der lokalen Zeitzone eindeutig darstellen kann. Eine Beschreibung der Fälle, in denen die DateTime-Struktur bzw. die DateTimeOffset-Struktur beim Arbeiten mit Datums- und Zeitwerten verwendet wird, finden Sie unter Auswählen zwischen "DateTime", "DateTimeOffset" und "TimeZoneInfo".

Beschreibungen der Zeitwerte im DateTime-Typ werden oft mithilfe des Standards der koordinierten Weltzeit (Coordinated Universal Time, UTC) ausgedrückt. Dies ist der international anerkannte Name für Greenwich Mean Time (GMT). Koordinierte Weltzeit ist die auf dem Längengrad 0, dem UTC-Ursprungspunkt, gemessene Zeit. Sommerzeit wird bei UTC nicht berücksichtigt.

Die lokale Zeit ist relativ zu einer bestimmten Zeitzone. Eine Zeitzone ist einem Zeitzonenoffset zugeordnet, der den Versatz der Zeitzone in Stunden vom UTC-Ursprungspunkt angibt. Zusätzlich wird bei der lokalen Zeit optional die Sommerzeit berücksichtigt, wodurch von der Dauer eines Tages eine Stunde abgezogen oder zu dieser hinzuaddiert wird. Folglich wird die lokale Zeit durch Addieren des Zeitzonenoffsets zu UTC und ggf. Berücksichtigen der Sommerzeit berechnet. Der Zeitzonenoffset am UTC-Ursprungspunkt ist 0 (null).

Die UTC-Zeit ist für Berechnungen, Vergleiche und das Speichern von Datums- und Zeitangaben in Dateien geeignet. Die Ortszeit ist für die Anzeige in Benutzeroberflächen von Desktopanwendungen geeignet. Anwendungen, die Zeitzonen unterstützen (z. B. viele Webanwendungen), müssen darüber hinaus mit einer Anzahl von anderen Zeitzonen arbeiten.

Wenn die Kind-Eigenschaft eines DateTime-Objekts DateTimeKind.Unspecified ist, ist keine Angabe vorhanden, ob die dargestellte Zeit die Ortszeit, UTC-Zeit oder eine Zeit in einer anderen Zeitzone ist.

Durch Berechnungen mit einer DateTime-Struktur, z. B. Add oder Subtract wird der Wert der Struktur nicht geändert. Die Berechnung gibt hingegen eine neue DateTime-Struktur zurück, deren Wert das Ergebnis der Berechnung ist.

Bei Konvertierungsoperationen zwischen Zeitzonen (z. B. zwischen UTC-Zeit und Ortszeit oder zwischen zwei Zeitzonen) wird die Sommerzeit berücksichtigt, bei arithmetischen und Vergleichsoperationen hingegen nicht.

Die DateTime-Struktur selbst verfügt über eine begrenzte Unterstützung für das Konvertieren zwischen Zeitzonen. Sie können mit der ToLocalTime-Methode UTC in Ortszeit konvertieren oder mit der ToUniversalTime-Methode eine Konvertierung von der Ortszeit in UTC durchführen. Der vollständige Satz der Konvertierungsmethoden für Zeitzonen ist jedoch in der TimeZoneInfo-Klasse verfügbar. Mit diesen Methoden können Sie die Zeit in einer beliebigen Zeitzone in die Zeit einer beliebigen anderen Zeitzone konvertieren.

Berechnungen und Vergleiche von DateTime-Objekten sind nur dann sinnvoll, wenn die Objekte Zeitangaben in der gleichen Zeitzone darstellen. Sie können mit einem TimeZoneInfo-Objekt die Zeitzone eines DateTime-Werts darstellen, auch wenn diese lose verknüpft sind. (Das heißt, ein DateTime-Objekt verfügt über keine Eigenschaft, die ein Objekt zurückgibt, das eine andere Zeitzone für den betreffenden Datums- und Zeitwert als die Kind-Eigenschaft darstellt.) Aus diesem Grund müssen Sie sich in einer Anwendung, die Zeitzonen erkennt, auf einen externen Mechanismus stützen, um die Zeitzone zu bestimmen, in der ein DateTime-Objekt erstellt wurde. Sie können z. B. eine Struktur verwenden, die den DateTime-Wert und das TimeZoneInfo-Objekt umschließt, das die Zeitzone des DateTime-Werts darstellt. Einzelheiten zum Verwenden von UTC in Berechnungen und Vergleichen mit DateTime-Werten finden Sie unter Durchführen arithmetischer Datums- und Uhrzeitoperationen.

Alle DateTime-Member verwenden implizit den gregorianischen Kalender für Operationen. Ausnahmen hierbei sind Konstruktoren, die einen Kalender angeben, und Methoden mit einem von IFormatProvider abgeleiteten Parameter, z. B. System.Globalization.DateTimeFormatInfo, durch den implizit ein Kalender angegeben wird.

Operation durch Member des DateTime-Typs berücksichtigen Einzelheiten wie Schaltjahre und die Anzahl der Tage eines Monats.

Die Werttypen DateTime und TimeSpan unterscheiden sich darin, dass DateTime einen Zeitpunkt und TimeSpan ein Zeitintervall darstellt. Dies bedeutet z. B., dass Sie eine Instanz von DateTime von einer anderen subtrahieren können, um ein TimeSpan-Objekt zu erhalten, dass das zwischen ihnen liegende Zeitintervall darstellt. Sie können auch eine positive TimeSpan zur aktuellen DateTime addieren, um einen DateTime-Wert zu erhalten, der ein Datum in der Zukunft darstellt.

Sie können ein Zeitintervall zu einem DateTime-Objekt addieren oder von diesem subtrahieren. Zeitintervalle können negativ oder positiv sein, in Einheiten wie Ticks oder Sekunden oder als TimeSpan-Objekt ausgedrückt werden.

Ein DateTime-Wert, der an eine COM-Anwendung übertragen wird, wird dann im so genannten Round-Trip zurück an die verwaltete Anwendung übertragen. Ein DateTime-Wert, der nur eine Zeit angibt, verhält sich im Round-Trip hingegen nicht wie erwartet.

Wenn Sie einen Roundtrip nur für eine Zeit ausführen, z. B. 3 Uhr nachmittags, lauten das abschließende Datum und die Uhrzeit 30. Dezember 1899 u. Z. um 15:00 Uhr, statt am 1. Januar 0001 u. Z. um 15:00 Uhr. Dies geschieht, da .NET Framework und COM ein Standarddatum annehmen, wenn nur eine Zeit angegeben wird. Das COM-System nimmt jedoch als Basisdatum den 30. Dezember 1899 u. Z. an. während .NET Framework als Basisdatum den 1. Januars 0001 u. Z. annimmt.

Wenn von .NET Framework an COM nur eine Zeit übergeben wird, wird eine besondere Verarbeitung ausgeführt, bei die Zeit in das von COM verwendete Format konvertiert wird. Wenn von COM an .NET Framework nur eine Zeit übergeben wird, wird keine besondere Verarbeitung ausgeführt, weil diese korrekte Datums- und Zeitangaben am und vor dem 30. Dezember 1899 beschädigen würde. Dies bedeutet auch, wenn ein Datum den Roundtrip aus COM startet, dass .NET Framework und COM das Datum beibehalten.

Das Verhalten von .NET Framework und COM bedeutet, dass bei einem Round-Trip einer DateTime in der Anwendung, mit der nur eine Zeit angegeben wird, die Anwendung die Aufgabe hat, falsche Datumsangaben im letztgültigen DateTime-Objekt zu ändern oder zu ignorieren.