DateValue-Funktion (Visual Basic)
Aktualisiert: November 2007
Gibt einen Date-Wert zurück, der die Datumsangabe als Zeichenfolge enthält und dessen Zeitangabe Mitternacht (00:00:00) lautet.
Public Function DateValue(ByVal StringDate As String) As DateTime
Parameter
- StringDate
Erforderlich. String-Ausdruck, der ein Datum und eine Uhrzeit zwischen 00:00:00 Uhr am 1. Januar des Jahres 1 und 23:59:59 Uhr am 31. Dezember 9999 angibt.
Ausnahmen
Ausnahmetyp |
Fehlernummer |
Bedingung |
|---|---|---|
StringDate enthält eine ungültige Zeitangabe. |
Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.
Hinweise
Wenn StringDate nur Zahlen von 1 bis 12 enthält, die durch gültige Datumstrennzeichen getrennt sind, erkennt DateValue die Reihenfolge für Monat, Tag und Jahr entsprechend dem für Ihr System festgelegten kurzen Datumsformat. DateValue verwendet die aktuelle Kalendereinstellung der CurrentCulture-Eigenschaft der CultureInfo-Klasse im System.Globalization-Namespace. Die Standardwerte für CurrentCulture werden durch die Einstellungen in der Systemsteuerung bestimmt. Sie können das kurze Datumsformat überschreiben, indem Sie die ShortDatePattern-Eigenschaft der DateTimeFormatInfo-Klasse im System.Globalization-Namespace festlegen.
DateValue erkennt Monatsnamen im langen, im abgekürzten und im numerischen Format. DateValue erkennt z. B. neben 30.12.1991 und 30.12.91 auch 30. Dezember 1991 und 30. Dez. 1991.
Wenn das Jahr in StringDate nicht angegeben wird, verwendet DateValue das aktuelle Jahr aus dem Systemdatum des Computers.
Wenn das StringDate-Argument eine Zeitangabe umfasst, so ist diese nicht im Rückgabewert von DateValue enthalten. Wenn StringDate jedoch eine ungültige Zeitangabe enthält, z. B. 89:98, tritt ein InvalidCastException-Fehler auf.
Beispiel
In diesem Beispiel wird die DateValue-Funktion dazu verwendet, eine Zeichenfolge in ein Datum zu konvertieren. Sie können auch Datumsliterale verwenden, um ein Datum direkt einer Object-Variablen oder einer Date-Variablen zuzuordnen, z. B. oldDate = #2/12/69#.
Dim oldDate As Date
oldDate = DateValue("February 12, 1969")
Anforderungen
Namespace:Microsoft.VisualBasic
**Modul:**DateAndTime
**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)
Siehe auch
Referenz
DateSerial-Funktion (Visual Basic)
TimeSerial-Funktion (Visual Basic)
TimeValue-Funktion (Visual Basic)