(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

DateTime-Struktur

Stellt einen Zeitpunkt dar, der normalerweise durch Datum und Uhrzeit dargestellt wird.

Um .NET Framework-Quellcode für diesen Typ zu suchen, finden Sie unter Bezugsquelle.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

[SerializableAttribute]
public struct DateTime : IComparable, IFormattable, 
	IConvertible, ISerializable, IComparable<DateTime>, IEquatable<DateTime>

Der DateTime-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsDateTime(Int64)Initialisiert eine neue Instanz der DateTime-Struktur mit der angegebenen Anzahl von Ticks.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsDateTime(Int64, DateTimeKind)Initialisiert eine neue Instanz der DateTime-Struktur mit einer angegebenen Anzahl von Ticks und koordinierter Weltzeit (UTC) oder lokaler Zeit.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsDateTime(Int32, Int32, Int32)Initialisiert eine neue Instanz der DateTime-Struktur mit dem angegebenen Jahr, Monat und Tag.
Öffentliche MethodeUnterstützt von XNA FrameworkDateTime(Int32, Int32, Int32, Calendar)Initialisiert eine neue Instanz der DateTime-Struktur mit dem angegebenen Jahr, Monat und Tag für den angegebenen Kalender.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsDateTime(Int32, Int32, Int32, Int32, Int32, Int32)Initialisiert eine neue Instanz der DateTime-Struktur mit den angegebenen Werten für Jahr, Monat, Tag, Stunde, Minute und Sekunde.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsDateTime(Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)Initialisiert eine neue Instanz der DateTime-Struktur mit den angegebenen Werten für Jahr, Monat, Tag, Stunde, Minute, Sekunde und koordinierte Weltzeit (Coordinated Universal Time, UTC) oder lokale Zeit.
Öffentliche MethodeUnterstützt von XNA FrameworkDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Calendar)Initialisiert eine neue Instanz der DateTime-Struktur mit den angegebenen Werten für Jahr, Monat, Tag, Stunde, Minute und Sekunde für den angegebenen Kalender.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)Initialisiert eine neue Instanz der DateTime-Struktur mit den angegebenen Werten für Jahr, Monat, Tag, Stunde, Minute, Sekunde und Millisekunde.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)Initialisiert eine neue Instanz der DateTime-Struktur mit den angegebenen Werten für Jahr, Monat, Tag, Stunde, Minute, Sekunde, Millisekunde und koordinierte Weltzeit (Coordinated Universal Time, UTC) oder lokale Zeit.
Öffentliche MethodeUnterstützt von XNA FrameworkDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar)Initialisiert eine neue Instanz der DateTime-Struktur mit den angegebenen Werten für Jahr, Monat, Tag, Stunde, Minute, Sekunde und Millisekunde für den angegebenen Kalender.
Öffentliche MethodeUnterstützt von XNA FrameworkDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, DateTimeKind)Initialisiert eine neue Instanz der DateTime-Struktur mit den angegebenen Werten für Jahr, Monat, Tag, Stunde, Minute, Sekunde, Millisekunde und koordinierte Weltzeit (Coordinated Universal Time, UTC) oder lokale Zeit für den angegebenen Kalender.
Zum Seitenanfang

  NameBeschreibung
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsDateRuft die Datumskomponente dieser Instanz ab.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsDayRuft den Tag des Monats ab, der durch diese Instanz dargestellt wird.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsDayOfWeekRuft den Wochentag ab, der durch diese Instanz dargestellt wird.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsDayOfYearRuft den Tag des Jahres ab, der durch diese Instanz dargestellt wird.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsHourRuft die Komponente für die Stunden des Datums ab, das durch diese Instanz dargestellt wird.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsKindRuft einen Wert ab, der angibt, ob die durch diese Instanz dargestellte Zeit auf lokaler Zeit, koordinierter Weltzeit (UTC) oder keinem von beiden basiert.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsMillisecondRuft die Komponente für die Millisekunden des Datums ab, das durch diese Instanz dargestellt wird.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsMinuteRuft die Komponente für die Minuten des Datums ab, das durch diese Instanz dargestellt wird.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsMonthRuft die Komponente für den Monat des Datums ab, das durch diese Instanz dargestellt wird.
Öffentliche EigenschaftStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsNowRuft ein DateTime-Objekt ab, das auf das aktuelle Datum und die aktuelle Zeit auf dem lokalen Rechner als lokale Zeit festgelegt ist.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsSecondRuft die Komponente für die Sekunden des Datums ab, das durch diese Instanz dargestellt wird.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsTicksRuft die Anzahl der Ticks ab, die Datum und Uhrzeit dieser Instanz darstellen.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsTimeOfDayRuft die Uhrzeit für diese Instanz ab.
Öffentliche EigenschaftStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsTodayRuft das aktuelle Datum ab.
Öffentliche EigenschaftStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsUtcNowRuft ein DateTime-Objekt ab, das auf das aktuelle Datum und die aktuelle Zeit als koordinierte Weltzeit (UTC) festgelegt ist.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsYearRuft die Komponente für das Jahr des Datums ab, das durch diese Instanz dargestellt wird.
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsAddGibt einen neuen DateTime-Wert zurück, der den Wert des angegebenen TimeSpan-Werts zum Wert dieser Instanz addiert.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsAddDaysGibt einen neuen DateTime-Wert zurück, der die angegebene Anzahl von Tagen zum Wert dieser Instanz addiert.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsAddHoursGibt einen neuen DateTime-Wert zurück, der die angegebene Anzahl von Stunden zum Wert dieser Instanz addiert.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsAddMillisecondsGibt einen neuen DateTime-Wert zurück, der die angegebene Anzahl der Millisekunden zum Wert dieser Instanz addiert.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsAddMinutesGibt einen neuen DateTime-Wert zurück, der die angegebene Anzahl der Minuten zum Wert dieser Instanz addiert.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsAddMonthsGibt einen neuen DateTime-Wert zurück, der die angegebene Anzahl der Monate zum Wert dieser Instanz addiert.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsAddSecondsGibt einen neuen DateTime-Wert zurück, der die angegebene Anzahl der Sekunden zum Wert dieser Instanz addiert.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsAddTicksGibt einen neuen DateTime-Wert zurück, der die angegebene Anzahl der Ticks zum Wert dieser Instanz addiert.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsAddYearsGibt einen neuen DateTime-Wert zurück, der die angegebene Anzahl der Jahre zum Wert dieser Instanz addiert.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsCompareVergleicht zwei Instanzen von DateTime und gibt eine ganze Zahl zurück, die angibt, ob die erste Instanz früher oder später als die zweite Instanz ist oder ob sie mit dieser identisch ist.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsCompareTo(DateTime)Vergleicht den Wert dieser Instanz mit einem angegebenen DateTime-Wert und gibt eine Ganzzahl zurück, die angibt, ob diese Instanz vor oder nach dem angegebenen DateTime-Wert liegt oder diesem entspricht.
Öffentliche MethodeUnterstützt von XNA FrameworkCompareTo(Object)Vergleicht den Wert dieser Instanz mit einem angegebenen Objekt, das einen angegebenen DateTime-Wert enthält, und gibt eine Ganzzahl zurück, die angibt, ob diese Instanz vor oder nach dem angegebenen DateTime-Wert liegt oder diesem entspricht.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsDaysInMonthGibt die Anzahl der Tage im angegebenen Monat und Jahr zurück.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsEquals(DateTime)Gibt einen Wert zurück, der angibt, ob der Wert dieser Instanz gleich dem Wert der angegebenen DateTime-Instanz ist.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsEquals(Object)Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Überschreibt ValueType.Equals(Object).)
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsEquals(DateTime, DateTime)Gibt einen Wert zurück, der angibt, ob zwei DateTime-Instanzen denselben Datum- und Zeitwert besitzen.
Öffentliche MethodeStatischer MemberUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsFromBinaryDeserialisiert einen 64-Bit-Binärwert und erstellt ein ursprüngliches serialisiertes DateTime-Objekt neu.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsFromFileTimeKonvertiert die angegebene Windows-Dateizeit in eine entsprechende lokale Zeit.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsFromFileTimeUtcKonvertiert die angegebene Windows-Dateizeit in eine entsprechende UTC-Zeit.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkFromOADateGibt eine DateTime zurück, die dem angegebenen Datum für die OLE-Automatisierung entspricht.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsGetDateTimeFormats()Konvertiert den Wert dieser Instanz in alle Zeichenfolgenentsprechungen, die von den Standardformatbezeichnern für Datum und Uhrzeit unterstützt werden.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsGetDateTimeFormats(Char)Konvertiert den Wert dieser Instanz in alle Zeichenfolgenentsprechungen, die von den angegebenen Standardformatbezeichnern für Datum und Uhrzeit unterstützt werden.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsGetDateTimeFormats(IFormatProvider)Konvertiert den Wert dieser Instanz in alle Zeichenfolgenentsprechungen, die von den Standardformatbezeichnern für Datum und Uhrzeit und den angegebenen kulturabhängigen Formatierungsinformationen unterstützt werden.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsGetDateTimeFormats(Char, IFormatProvider)Konvertiert den Wert dieser Instanz in alle Zeichenfolgenentsprechungen, die von dem angegebenen Standardformatbezeichner für Datum und Uhrzeit und den angegebenen kulturabhängigen Formatierungsinformationen unterstützt werden.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsGetHashCodeGibt den Hashcode für diese Instanz zurück. (Überschreibt ValueType.GetHashCode().)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkGetTypeCodeGibt TypeCode für den Werttyp DateTime zurück.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsIsDaylightSavingTimeGibt an, ob sich diese Instanz von DateTime im Sommerzeitbereich für die aktuelle Zeitzone befindet.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsIsLeapYearGibt eine Angabe darüber zurück, ob das angegebene Jahr ein Schaltjahr ist.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsParse(String)Konvertiert die Zeichenfolgendarstellung einer Datums- und Uhrzeitangabe in die entsprechende DateTime.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsParse(String, IFormatProvider)Konvertiert die Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung der kulturabhängigen Formatierungsinformationen in die entsprechende DateTime.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsParse(String, IFormatProvider, DateTimeStyles)Konvertiert die Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung der kulturabhängigen Formatierungsinformationen und Formatierungsstil in die entsprechende DateTime.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsParseExact(String, String, IFormatProvider)Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung des angegebenen Formats und der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende DateTime. Das Format der Zeichenfolgenentsprechung muss dem angegebenen Format genau entsprechen.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsParseExact(String, String, IFormatProvider, DateTimeStyles)Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung der Angaben über Format, kulturabhängige Formatierungsinformationen und Stil in die entsprechende DateTime. Das Format der Zeichenfolgendarstellung muss dem angegebenen Format genau entsprechen. Andernfalls wird eine Ausnahme ausgelöst.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsParseExact(String, String[], IFormatProvider, DateTimeStyles)Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung des angegebenen Formatarrays, der kulturspezifischen Formatierungsinformationen und des Stils in die DateTime-Entsprechung. Das Format der Zeichenfolgendarstellung muss mindestens einem der angegebenen Formate genau entsprechen. Andernfalls wird eine Ausnahme ausgelöst.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsSpecifyKindErstellt ein neues DateTime-Objekt, das über die gleiche Anzahl von Ticks wie die angegebene DateTime verfügt, aber entsprechend dem DateTimeKind-Wert in Ortszeit, koordinierter Weltzeit (Coordinated Universal Time, UTC) oder keinem von beidem angegeben ist.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsSubtract(DateTime)Subtrahiert die angegebene Datums- und Uhrzeitangabe von dieser Instanz.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsSubtract(TimeSpan)Subtrahiert die angegebene Dauer von dieser Instanz.
Öffentliche MethodeUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsToBinarySerialisiert das aktuelle DateTime-Objekt in einen 64-Bit-Binärwert, der dann zum erneuten Erstellen des DateTime-Objekts verwendet werden kann.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsToFileTimeKonvertiert den Wert des aktuellen DateTime-Objekts in eine Windows-Dateizeit.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsToFileTimeUtcKonvertiert den Wert des aktuellen DateTime-Objekts in eine Windows-Dateizeit.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsToLocalTimeKonvertiert den Wert des aktuellen DateTime-Objekts in eine lokale Zeit.
Öffentliche MethodeUnterstützt von XNA FrameworkToLongDateStringKonvertiert den Wert des aktuellen DateTime-Objekts in die entsprechende Zeichenfolgendarstellung im langen Datumsformat.
Öffentliche MethodeUnterstützt von XNA FrameworkToLongTimeStringKonvertiert den Wert des aktuellen DateTime-Objekts in die entsprechende Zeichenfolgendarstellung im langen Zeitformat.
Öffentliche MethodeUnterstützt von XNA FrameworkToOADateKonvertiert den Wert dieser Instanz in das entsprechende Datum für OLE-Automatisierung.
Öffentliche MethodeUnterstützt von XNA FrameworkToShortDateStringKonvertiert den Wert des aktuellen DateTime-Objekts in die entsprechende Zeichenfolgendarstellung im kurzen Datumsformat.
Öffentliche MethodeUnterstützt von XNA FrameworkToShortTimeStringKonvertiert den Wert des aktuellen DateTime-Objekts in die entsprechende Zeichenfolgendarstellung im kurzen Zeitformat.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsToString()Konvertiert den Wert des aktuellen DateTime-Objekts in die entsprechende Zeichenfolgendarstellung. (Überschreibt ValueType.ToString().)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsToString(IFormatProvider)Konvertiert den Wert des aktuellen DateTime-Objekts unter Verwendung der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsToString(String)Konvertiert den Wert des aktuellen DateTime-Objekts mit dem angegebenen Format in die entsprechende Zeichenfolgendarstellung.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsToString(String, IFormatProvider)Konvertiert den Wert des aktuellen DateTime-Objekts unter Verwendung des angegebenen Formats sowie der kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsToUniversalTimeKonvertiert den Wert des aktuellen DateTime-Objekts in koordinierte Weltzeit (UTC).
Öffentliche MethodeStatischer MemberUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsTryParse(String, DateTime)Konvertiert die angegebene Zeichenfolgendarstellung einer Datums- und Uhrzeitangabe in deren DateTime-Entsprechung und gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich ausgeführt wurde.
Öffentliche MethodeStatischer MemberUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsTryParse(String, IFormatProvider, DateTimeStyles, DateTime)Konvertiert die angegebene Zeichenfolgendarstellung einer Datums- und Uhrzeitangabe unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen und des Formatierungsstils in die entsprechende DateTime und gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich abgeschlossen wurde.
Öffentliche MethodeStatischer MemberUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsTryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung der Angaben über Format, kulturabhängige Formatierungsinformationen und Stil in die entsprechende DateTime. Das Format der Zeichenfolgenentsprechung muss dem angegebenen Format genau entsprechen. Die Methode gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich abgeschlossen wurde.
Öffentliche MethodeStatischer MemberUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsTryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)Konvertiert die angegebene Zeichenfolgenentsprechung einer Datums- und Uhrzeitangabe unter Verwendung des angegebenen Formatarrays, der kulturspezifischen Formatierungsinformationen und des Stils in die DateTime-Entsprechung. Das Format der Zeichenfolgenentsprechung muss mindestens einem der angegebenen Formate genau entsprechen. Die Methode gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich abgeschlossen wurde.
Zum Seitenanfang

  NameBeschreibung
Öffentlicher OperatorStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsAdditionAddiert ein angegebenes Zeitintervall zu einer Datums- und Uhrzeitangabe und gibt eine neue Datums- und Uhrzeitangabe zurück.
Öffentlicher OperatorStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsEqualityBestimmt, ob zwei angegebene Instanzen von DateTime gleich sind.
Öffentlicher OperatorStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsGreaterThanBestimmt, ob eine angegebene DateTime später als eine andere angegebene DateTime ist.
Öffentlicher OperatorStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsGreaterThanOrEqualBestimmt, ob ein bestimmtes DateTime ein Datum und eine Uhrzeit darstellt, die gleichzeitig oder später ist, als ein anderes festgelegtes DateTime.
Öffentlicher OperatorStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsInequalityBestimmt, ob zwei angegebene Instanzen von DateTime ungleich sind.
Öffentlicher OperatorStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsLessThanBestimmt, ob eine angegebene DateTime früher als eine andere angegebene DateTime ist.
Öffentlicher OperatorStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsLessThanOrEqualBestimmt, ob ein bestimmtes DateTime ein Datum und eine Uhrzeit darstellt, die gleichzeitig oder früher ist, als ein anderes festgelegtes DateTime.
Öffentlicher OperatorStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsSubtraction(DateTime, DateTime)Subtrahiert eine angegebene Datums- und Uhrzeitangabe von einer anderen Datums- und Uhrzeitangabe und gibt ein Zeitintervall zurück.
Öffentlicher OperatorStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsSubtraction(DateTime, TimeSpan)Subtrahiert ein angegebenes Zeitintervall von einer Datums- und Uhrzeitangabe und gibt eine neue Datums- und Uhrzeitangabe zurück.
Zum Seitenanfang

  NameBeschreibung
Öffentliches FeldStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsMaxValueStellt den größtmöglichen Wert von DateTime dar. Dieses Feld ist schreibgeschützt.
Öffentliches FeldStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsMinValueStellt den kleinstmöglichen Wert von DateTime dar. Dieses Feld ist schreibgeschützt.
Zum Seitenanfang

  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsIComparable.CompareToVergleicht die aktuelle Instanz mit einem anderen Objekt vom selben Typ und gibt eine ganze Zahl zurück, die angibt, ob diese Instanz in der Sortierreihenfolge vor oder nach dem anderen Objekt oder an derselben Position auftritt.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToBooleanInfrastruktur. Diese Konvertierung wird nicht unterstützt. Bei dem Versuch der Verwendung dieser Methode wird eine InvalidCastException ausgelöst.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToByteInfrastruktur. Diese Konvertierung wird nicht unterstützt. Bei dem Versuch der Verwendung dieser Methode wird eine InvalidCastException ausgelöst.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToCharInfrastruktur. Diese Konvertierung wird nicht unterstützt. Bei dem Versuch der Verwendung dieser Methode wird eine InvalidCastException ausgelöst.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToDateTimeInfrastruktur. Gibt das aktuelle DateTime-Objekt zurück.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToDecimalInfrastruktur. Diese Konvertierung wird nicht unterstützt. Bei dem Versuch der Verwendung dieser Methode wird eine InvalidCastException ausgelöst.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToDoubleInfrastruktur. Diese Konvertierung wird nicht unterstützt. Bei dem Versuch der Verwendung dieser Methode wird eine InvalidCastException ausgelöst.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToInt16Infrastruktur. Diese Konvertierung wird nicht unterstützt. Bei dem Versuch der Verwendung dieser Methode wird eine InvalidCastException ausgelöst.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToInt32Infrastruktur. Diese Konvertierung wird nicht unterstützt. Bei dem Versuch der Verwendung dieser Methode wird eine InvalidCastException ausgelöst.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToInt64Infrastruktur. Diese Konvertierung wird nicht unterstützt. Bei dem Versuch der Verwendung dieser Methode wird eine InvalidCastException ausgelöst.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToSByteInfrastruktur. Diese Konvertierung wird nicht unterstützt. Bei dem Versuch der Verwendung dieser Methode wird eine InvalidCastException ausgelöst.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToSingleInfrastruktur. Diese Konvertierung wird nicht unterstützt. Bei dem Versuch der Verwendung dieser Methode wird eine InvalidCastException ausgelöst.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToTypeInfrastruktur. Konvertiert das aktuelle DateTime-Objekt in ein Objekt vom angegebenen Typ.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToUInt16Infrastruktur. Diese Konvertierung wird nicht unterstützt. Bei dem Versuch der Verwendung dieser Methode wird eine InvalidCastException ausgelöst.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToUInt32Infrastruktur. Diese Konvertierung wird nicht unterstützt. Bei dem Versuch der Verwendung dieser Methode wird eine InvalidCastException ausgelöst.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToUInt64Infrastruktur. Diese Konvertierung wird nicht unterstützt. Bei dem Versuch der Verwendung dieser Methode wird eine InvalidCastException ausgelöst.
Explizite SchnittstellenimplementierungPrivate MethodeISerializable.GetObjectDataFüllt ein SerializationInfo-Objekt mit den für das Serialisieren des aktuellen DateTime-Objekts erforderlichen Daten.
Zum Seitenanfang

Um .NET Framework-Quellcode für diesen Typ anzuzeigen, Sie finden. Bezugsquelle Sie können vom Quellcode online suchen, den Verweis für die Offlineanzeige herunterladen, und durch die Quellen (einschließlich der Patches und Updates) während des Debuggens werden; Sie finden Anweisungen.

Der DateTime stellt Werttyp Datums- und Uhrzeitwerten mit Werten dar, die von 00:00 reichen: 00 (Mitternacht) 0001 am 1. Januar Anno Domini (General Zeitraum) bis 11:59: 59 Uhr 9999 am 31. Dezember n. Chr. (&. Z.) im gregorianischen Kalender.

Zeitwerte werden in Einheiten von 100 Nanosekunden gemessen, die als Ticks bezeichnet werden. Ein bestimmtes Datum ist die Anzahl von Ticks seit dem 1. Januar 0001 n. Chr. 00:00:00 (U. Z.) im GregorianCalendar-Kalender (ohne Teilstriche, die bis Sprungsekunden hinzugefügt werden würden). Ein Tickswert von 31241376000000000 stellt z. B. Freitag, den 1. Januar 0100, 00:00:00 dar. Ein DateTime-Wert bezieht sich immer auf den Kontext eines expliziten Kalenders oder eines Standardkalenders.

HinweisHinweis

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. Zum Beispiel können Sie die Anzahl der Sekunden, die durch eine angegebene Anzahl von Teilstrichen dargestellt werden, mit dem Ausdruck dateValue.Second + nTicks/Timespan.TicksPerSecond zur Second-Komponente eines DateTime-Werts hinzufügen.

In diesem Abschnitt

Instanziieren eines Datum-Zeit-Objekts
Datum-Zeit-Werte sowie die Zeichenfolgenentsprechungen
Konvertieren von Zeichenfolgen in "DateTime"-Werten
Versionsüberlegungen
Datum-Zeit-Werte
Datum-Zeit-Vorgänge
DateTime und TimeSpan
COM-Interop-Überlegungen

Instanziieren eines Datum-Zeit-Objekts

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.

    
    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.

    
    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.

    
    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.

    
    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.

    
    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));
    
    
    

Datum-Zeit-Werte sowie die Zeichenfolgenentsprechungen

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


Weitere Informationen zum Formatieren von DateTime-Werten finden Sie unter Standard-Formatzeichenfolgen für Datum und Uhrzeit und Benutzerdefinierte Formatzeichenfolgen für Datum und Uhrzeit.

Konvertieren von Zeichenfolgen in "DateTime"-Werten

Die Analyse umfasst das Konvertieren der Zeichenfolgendarstellung eines Datums und einer Uhrzeit in einen DateTime-Wert. In der Regel haben eingegebene Datums- und Uhrzeitzeichenfolgen zwei unterschiedliche Verwendung in Anwendungen:

  • Sie stellen ein Datum und eine Uhrzeit dar, die eine Vielzahl verwenden können und die Konventionen der aktuellen Kultur oder einer bestimmten Kultur widergespiegelt. Beispielsweise ermöglicht auch eine Anwendung einem Benutzer, dessen aktuelle Kultur en-US ist, um eines Datumswerts als "12/15/2013" einzugeben oder "am 15. Dezember 2013", und kann ein Benutzer, dessen aktuelle Kultur "en-GB" ist, um eines Datumswerts als "15/12/2013" einzugeben oder "am 15. Dezember 2013".

  • Sie stellen ein Datum und eine Uhrzeit in einem vordefinierten Format dar. Beispielsweise serialisiert Eine Anwendung kann ein Datum als "20130103" unabhängig von der Kultur, auf dem die App ausgeführt wird, oder sie erforderlich, dass ein Datum in kurzen Datumsformat der aktuellen Kultur eingegeben wird.

Sie können die Parse oder TryParse-Methode verwenden, um eine Zeichenfolge zu konvertieren, die möglicherweise eines der allgemeinen Datums- und Uhrzeitformate mitteilte, die von einer Kultur an einen DateTime-Wert verwendet werden. Das folgende Beispiel zeigt, wie Sie TryParse verwenden können, um Datumszeichenfolgen in verschiedenen Formaten kulturspezifischen auf ein DateTime-Wert zu konvertieren. Es wird die aktuelle Kultur in Englisch (Großbritannien) und zu den Aufrufen die GetDateTimeFormats()-Methode, um ein Array eingegebene Datums- und Uhrzeitzeichenfolgen zu generieren. Anschließend wird jedes Element im Array an die TryParse-Methode. Die Ausgabe im Beispiel zeigt, dass die Analysemethode in der Lage ist, jede der kulturspezifischen eingegebene Datums- und Uhrzeitzeichenfolgen erfolgreich zu konvertieren.

Sie können die TryParse und TryParseExact werden statische Methoden verwenden, um einen Datums- und Uhrzeitzeichenfolge konvertiert, die ein bestimmter Stil oder Stile an einen DateTime-Wert entsprechen muss. Sie geben den erforderlichen Format oder Stilen als Parameter der Analysemethode an, indem Sie eine oder mehrere Standardwert oder benutzerdefiniert Formatzeichenfolgen für Datum und Uhrzeit verwenden. Im folgenden Beispiel wird die TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) methode, um Zeichenfolgen zu konvertieren, die entweder in einem "yyyyMMdd" Format oder im Format "HHmmss" DateTime-Werten sein müssen.

Die Parse und ParseExact-Methoden lösen eine Ausnahme aus, wenn die in einen DateTime-Wert konvertiert werden Zeichenfolge, nicht analysiert werden. Die TryParse und TryParseExact werden statische Methoden geben einen booleschen Wert zurück, der angibt, dass die Konvertierung erfolgreich war oder fehlgeschlagen ist. Da der Analysevorgang für Datums- Uhrzeitzeichenfolgen neigt, insbesondere wenn Zeichenfolgen von Benutzern eingegeben werden, eine hohe Fehlerrate zu sein, und da Ausnahmebehandlung ist aufwändig, sollten Sie TryParse oder die TryParseExact methoden in Szenarien verwenden, in denen die Leistung wichtig ist, oder Konvertierungen je einer hohen Rate Fehler sind.

Weitere Informationen zum Analysieren von Datums- und Uhrzeitwerten finden Sie unter Analyse-Datums- und Uhrzeitzeichenfolgen.

Versionsüberlegungen

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.

HinweisHinweis

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".

Datum-Zeit-Werte

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.

Datum-Zeit-Vorgänge

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.

Zwei andere allgemeine Vorgänge mit DateTime-Werten beinhalten, einen Datums- und Uhrzeitwert nach oder aus seiner Zeichenfolgendarstellung zu konvertieren. Der Prozess der Konvertierung eines DateTime-Wert in seine Zeichenfolgedarstellung ist ein Formatierungsvorgang; weitere Informationen zum Formatieren finden Sie unter Datum-Zeit-Werte sowie die Zeichenfolgenentsprechungen. Der Vorgang des Konvertierens der Zeichenfolgendarstellung eines Datums und einer Uhrzeit in einen DateTime-Wert ist ein Analysevorgang; weitere Informationen zur Analyse finden Sie unter Konvertieren von Zeichenfolgen in "DateTime"-Werten.

DateTime und TimeSpan

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.

COM-Interop-Überlegungen

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 nur eine Uhrzeit, wie 3 Uhr, der Endtermin einen Roundtrip und Zeit am 30. Dezember 1899 &. Z. um 3:00 Uhr, anstelle Januars, 1, 0001. und Z. um 3:00 Uhr Dies geschieht, da .NET Framework und COM ein Standarddatum annehmen, wenn nur eine Zeit angegeben wird. Allerdings setzt das ein COM-System niedriges Datum vom 30. Dezember 1899 &. Z., wenn .NET Framework ein Basis- Datum von Januar angenommen, 1, 0001 und Z. an.

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.

Im folgenden Beispiel wird das Vergleichen annähernd äquivalenter DateTime-Werte veranschaulicht, wobei ein geringer Unterschied für die Bestimmung als gleich zulässig ist.


using System;

class DateTimeTester 
{
   static bool RoughlyEquals(DateTime time, DateTime timeWithWindow, int windowInSeconds, int frequencyInSeconds)
   {
      long delta = (long)((TimeSpan)(timeWithWindow - time)).TotalSeconds 
                                                     % frequencyInSeconds;

      delta = delta > windowInSeconds ? frequencyInSeconds - delta : delta;

      return Math.Abs(delta) < windowInSeconds;
	}

	public static void Main() 
	{
      int window = 10;
      int freq = 60 * 60 * 2; // 2 hours;

      DateTime d1 = DateTime.Now;

      DateTime d2 = d1.AddSeconds(2 * window);
      DateTime d3 = d1.AddSeconds(-2 * window);
      DateTime d4 = d1.AddSeconds(window / 2);
      DateTime d5 = d1.AddSeconds(-window / 2);

      DateTime d6 = (d1.AddHours(2)).AddSeconds(2 * window);
      DateTime d7 = (d1.AddHours(2)).AddSeconds(-2 * window);
      DateTime d8 = (d1.AddHours(2)).AddSeconds(window / 2);
      DateTime d9 = (d1.AddHours(2)).AddSeconds(-window / 2);

      Console.WriteLine("d1 ({0}) ~= d1 ({1}): {2}",
                        d1, d1, RoughlyEquals(d1, d1, window, freq));
      Console.WriteLine("d1 ({0}) ~= d2 ({1}): {2}", 
                        d1, d2, RoughlyEquals(d1, d2, window, freq));
      Console.WriteLine("d1 ({0}) ~= d3 ({1}): {2}", 
                        d1, d3, RoughlyEquals(d1, d3, window, freq));
      Console.WriteLine("d1 ({0}) ~= d4 ({1}): {2}", 
                        d1, d4, RoughlyEquals(d1, d4, window, freq));
      Console.WriteLine("d1 ({0}) ~= d5 ({1}): {2}", 
                        d1, d5, RoughlyEquals(d1, d5, window, freq));

      Console.WriteLine("d1 ({0}) ~= d6 ({1}): {2}", 
                        d1, d6, RoughlyEquals(d1, d6, window, freq));
      Console.WriteLine("d1 ({0}) ~= d7 ({1}): {2}", 
                        d1, d7, RoughlyEquals(d1, d7, window, freq));
      Console.WriteLine("d1 ({0}) ~= d8 ({1}): {2}", 
                        d1, d8, RoughlyEquals(d1, d8, window, freq));
      Console.WriteLine("d1 ({0}) ~= d9 ({1}): {2}", 
                        d1, d9, RoughlyEquals(d1, d9, window, freq));
	}
}
// The example displays output similar to the following:
//    d1 (1/28/2010 9:01:26 PM) ~= d1 (1/28/2010 9:01:26 PM): True
//    d1 (1/28/2010 9:01:26 PM) ~= d2 (1/28/2010 9:01:46 PM): False
//    d1 (1/28/2010 9:01:26 PM) ~= d3 (1/28/2010 9:01:06 PM): False
//    d1 (1/28/2010 9:01:26 PM) ~= d4 (1/28/2010 9:01:31 PM): True
//    d1 (1/28/2010 9:01:26 PM) ~= d5 (1/28/2010 9:01:21 PM): True
//    d1 (1/28/2010 9:01:26 PM) ~= d6 (1/28/2010 11:01:46 PM): False
//    d1 (1/28/2010 9:01:26 PM) ~= d7 (1/28/2010 11:01:06 PM): False
//    d1 (1/28/2010 9:01:26 PM) ~= d8 (1/28/2010 11:01:31 PM): True
//    d1 (1/28/2010 9:01:26 PM) ~= d9 (1/28/2010 11:01:21 PM): True


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Portable Klassenbibliothek

Unterstützt in: Portable Klassenbibliothek

.NET für Windows Store-Apps

Unterstützt in: Windows 8

.NET für Windows Phone-Apps

Unterstützt in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle Member dieses Typs sind threadsicher. Member, die scheinbar den Zustand einer Instanz ändern, geben in Wirklichkeit eine neue Instanz zurück, die mit dem neuen Wert initialisiert wurde. Wie bei allen anderen Typen müssen Lese- und Schreibzugriffe auf eine freigegebene Variable, die eine Instanz dieses Typs enthält, durch eine Sperre geschützt werden, um die Threadsicherheit zu gewährleisten.

WarnhinweisVorsicht

Die Zuweisung einer Instanz dieses Typs ist nicht auf allen Hardwareplattformen threadsicher, da die binäre Darstellung der Instanz u. U. zu groß ist, sodass die Zuweisung nicht in einem einzelnen atomaren Vorgang abgeschlossen werden kann.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft