Freigeben über


TimeValue-Funktion (Visual Basic)

Aktualisiert: November 2007

Gibt einen Date-Wert zurück, der die Zeitangabe als Zeichenfolge enthält und dessen Datum der 1. Januar des Jahres 1 ist.

Public Function TimeValue(ByVal StringTime As String) As DateTime

Parameter

  • StringTime
    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

InvalidCastException

13

StringTime enthält ungültige Datumsinformationen.

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

Zeitangaben sind sowohl in der 12- als auch in der 24-Stunden-Schreibweise zulässig. Die Angaben "2:24 P.M." und "14:24" sind daher beide gültige StringTime-Argumente.

Wenn das StringTime-Argument eine Datumsangabe beinhaltet, so ist diese nicht im Rückgabewert von TimeValue enthalten. Wenn StringTime jedoch ungültige Datumsinformationen enthält (z. B. "32. Januar"), tritt ein InvalidCastException-Fehler auf.

Beispiel

Im folgenden Beispiel wird die TimeValue-Funktion dazu verwendet, eine Zeichenfolge in eine Zeitangabe zu konvertieren. Sie können auch Datumsliterale verwenden, um einer Date-Variablen direkt eine Zeitangabe zuzuweisen.

Dim thisTime As Date
thisTime = TimeValue("4:35:17 PM")

Anforderungen

Namespace:Microsoft.VisualBasic

**Modul:**DateAndTime

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Siehe auch

Referenz

DateTime

DateSerial-Funktion (Visual Basic)

DateValue-Funktion (Visual Basic)

Hour-Funktion (Visual Basic)

Minute-Funktion

Now-Eigenschaft

Second-Funktion (Visual Basic)

TimeSerial-Funktion (Visual Basic)

Date-Datentyp (Visual Basic)

TimeSpan