Gibt einen Wert des Typs Variant (Date) zurück, der die Uhrzeit enthält.
Syntax
TimeValue(time)
Das erforderliche Zeitargumentist normalerweise ein Zeichenfolgenausdruck, der eine Zeit von 0:00:00 (12:00:00 Uhr) bis einschließlich 23:59:59 (23:59:59 Uhr) darstellt. Time kann jedoch auch ein beliebiger Ausdruck sein, der eine Zeit in diesem Bereich darstellt. Wenn time Null enthält, wird Null zurückgegeben.
Hinweise
Sie können gültige Zeiten mit einer 12-Stunden- oder 24-Stunden-Uhr eingeben. Beispielsweise "2:24PM" sind und "14:24" gültige Zeitargumente .
Wenn das time-Argument Datumsinformationen enthält, gibt TimeValue diese nicht zurück. Wenn die Uhrzeit jedoch ungültige Datumsinformationen enthält, tritt ein Fehler auf.
Abfragebeispiele
| Ausdruck | Ergebnisse |
|---|---|
| SELECT TimeValue([DateTime]) AS Expr1 FROM ProductSales; | Gibt die Zeitwerte des Felds "DateTime" ohne die Datumsinformationen zurück und wird in der Spalte Expr1 angezeigt. |
| SELECT TimeValue([DateTime]) AS JustTime FROM ProductSales; | Gibt die Zeitwerte des Felds "DateTime" ohne die Datumsinformationen zurück und wird in der Spalte JustTime angezeigt. |
VBA-Beispiel
Hinweis
Die folgenden Beispiele zeigen die Verwendung dieser Funktion in einem VBA-Modul (Visual Basic for Applications). Wenn Sie weitere Informationen zum Arbeiten mit VBA wünschen, wählen Sie Entwicklerreferenz in der Dropdownliste neben Suchen aus, und geben Sie einen oder mehrere Begriffe in das Suchfeld ein.
In diesem Beispiel wird die TimeValue-Funktion verwendet, um eine Zeichenfolge in eine Uhrzeit zu konvertieren. Sie können auch Datumsliterale verwenden, um einer Variant- oder Date-Variablen direkt eine Uhrzeit zuzuweisen, z. B. MyTime = #4:35:17 PM#.
Dim MyTime
MyTime = TimeValue("4:35:17 PM") ' Return a time.