Gibt einen Wert des Typs Variant (Date) zurück, der die Uhrzeit enthält.
Syntax
TimeValue ( time )
Die erforderliche ZeitArgument ist normalerweise eine Zeichenfolgenausdruck, die eine Zeit von 0:00:00 (12:00:00 Uhr) bis einschließlich 23:59:59 Uhr (23:59:59 Uhr) darstellt. Zeit kann jedoch auch eine beliebige Ausdruck sein, die 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 sind "2:24PM" 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.