Date-Datentyp (Visual Basic)

  • Artikel

Enthält IEEE-64-Bit(8-Byte)-Werte, die Datumsangaben im Bereich vom 1. Januar des Jahres 0001 bis zum 31. Dezember des Jahres 9999 und Uhrzeiten von 00:00:00 Uhr (Mitternacht) bis 23:59:59.9999999 Uhr darstellen. Jedes Inkrement stellt 100 Nanosekunden verstrichener Zeit seit Beginn des 1. Januar des Jahres 1 im gregorianischen Kalender dar. Der maximale Wert stellt 100 Nanosekunden vor Beginn des 1. Januar des Jahres 10000 dar.

Bemerkungen

Verwenden Sie den Date-Datentyp, um Datumswerte, Uhrzeitwerte oder Datums-und Uhrzeitwerte einzuschließen.

Der Standardwert von Date ist 0:00:00 (Mitternacht) am 1. Januar 0001.

Sie erhalten das aktuelle Datum und die aktuelle Uhrzeit aus der DateAndTime-Klasse.

Formatanforderungen

Sie müssen einen Date-Literal zwischen Nummernzeichen (# #) einschließen. Sie müssen den Datumswert im Format M/T/JJJJ angeben, z. B. #5/31/1993#, oder JJJJ-MM-TT, z. B. #1993-5-31#. Wenn Sie das Jahr zuerst angeben, können Sie Schrägstriche verwenden. Dies gilt unabhängig vom Gebietsschema und den Formateinstellungen für Datum und Uhrzeit Ihres Computers.

Der Grund für diese Einschränkung ist, dass sich die Bedeutung des Codes nicht je nach dem Gebietsschema, in dem die Anwendung ausgeführt wird, ändern soll. Angenommen, Sie möchten ein Date-Literal von #3/4/1998# als vordefinierten Code aufnehmen und die Bedeutung 4. März 1998 festlegen. In einem Gebietsschema, das MM/TT/JJJJ verwendet, wird 3/4/1998 wie gewünscht kompiliert. Aber nehmen wir an, dass Sie die Anwendung in vielen Ländern/Regionen bereitstellen. In einem Gebietsschema, das TT/MM/JJJJ verwendet, würde das als vordefinierter Code aufgenommene Literal als 3. April 1998 kompiliert. In einem Gebietsschema, das JJJJ/MM/TT verwendet, wäre das Literal ungültig (1998. April 0003) und würde einen Compilerfehler verursachen.

Problemumgehung

Um ein Date-Literal in das Format Ihres Gebietsschemas oder in ein benutzerdefiniertes Format zu konvertieren, müssen Sie das Literal für die Format-Funktion bereitstellen und entweder ein vordefiniertes oder ein benutzerdefiniertes Datumsformat angeben. Dies wird im folgenden Beispiel veranschaulicht:

MsgBox("The formatted date is " & Format(#5/31/1993#, "dddd, d MMM yyyy"))

Alternativ können Sie einen der überladenen Konstruktoren der DateTime-Struktur verwenden, um einen Datums- und Uhrzeitwert zu assemblieren. Im folgenden Beispiel wird ein Wert für den 31. Mai 1993 um 12:14 Uhr nachmittags erstellt.

Dim dateInMay As New System.DateTime(1993, 5, 31, 12, 14, 0)

Stundenformat

Sie können den Zeitwert im 12- oder 24-Stunden-Format angeben, z. B. #1:15:30 PM# oder #13:15:30#. Wenn Sie allerdings weder Minuten noch Sekunden angeben, müssen Sie AM oder PM angeben.

Standardwerte für Datum und Uhrzeit

Wenn Sie in einem Datum-/Uhrzeit-Literal kein Datum angeben, legt Visual Basic den Datumsteil des Werts auf den 1. Januar 0001 fest. Wenn Sie in einem Datum-/Uhrzeit-Literal keine Uhrzeit angeben, legt Visual Basic den Uhrzeitteil des Werts auf den Beginn des Tages, d. h. Mitternacht (0:00:00) fest.

Typkonvertierungen

Beim Konvertieren eines Date-Werts in den String-Typ, gibt Visual Basic das Datum gemäß dem kurzen Datumsformat wieder, das vom Laufzeitgebietsschema angegeben wird, und die Uhrzeit gemäß dem Zeitformat (entweder 12- oder 24-Stunden-Format), das vom Laufzeitgebietsschema angegeben wird.

Programmiertipps

  • Interop-Überlegungen. Wenn Sie Komponenten anbinden, die nicht für .NET Framework geschrieben wurden (z. B. Automatisierungs- oder COM-Objekte), müssen Sie beachten, dass Datums-/Uhrzeittypen in anderen Umgebungen nicht zum Date-Typ von Visual Basic kompatibel sind. Wenn Sie ein Datums-/Uhrzeitargument an eine solche Komponente übergeben, deklarieren Sie es im neuen Visual Basic-Code als Double und nicht als Date, und verwenden Sie die Konvertierungsmethoden DateTime.FromOADate und DateTime.ToOADate.

  • Typzeichen. Date hat kein Literal-Typzeichen oder Bezeichner-Typzeichen. Der Compiler behandelt jedoch Literale, die in Nummernzeichen (# #) eingeschlossen sind, als Date.

  • Framework-Typ. Der entsprechende Typ in .NET Framework ist die System.DateTime-Struktur.

Beispiel

Eine Variable oder Konstante des Date-Datentyps enthält das Datum und die Uhrzeit. Dies wird anhand des folgenden Beispiels veranschaulicht.

Dim someDateAndTime As Date = #8/13/2002 12:14 PM#

Siehe auch