Zwraca wartość typu wariant (data) zawierającą godzinę.
Składnia
TimeValue ( time )
Wymagany czasargument zwykle jest wyrażenie tekstowe reprezentujący czas od 0:00:00 (12:00:00) do 23:59:59 (23:59:59) włącznie. Jednak czasem może być również dowolna wyrażenie reprezentująca godzinę w tym zakresie. Jeśli argument czas zawiera wartość Null, funkcja zwraca wartość Null .
Uwagi
Prawidłowe godziny można wprowadzać przy użyciu zegara 12-godzinnego lub 24-godzinnego. Na przykład argumenty "2:24PM" i "14:24" są prawidłowymi argumentami czasu .
Jeśli argument time zawiera informacje o dacie, funkcja TimeValue nie zwraca tej wartości. Jeśli jednak godzina zawiera nieprawidłowe informacje o dacie, wystąpi błąd.
Przykłady zapytań
Expression |
Wyniki |
SELECT TimeValue([DateTime]) AS Expr1 FROM ProductSales; |
Zwraca wartości czasu pola "DateTime" bez informacji o dacie i są wyświetlane w kolumnie Wyr1. |
SELECT TimeValue([DateTime]) AS JustTime FROM ProductSales; |
Zwraca wartości czasu pola "DateTime" bez informacji o dacie i wyświetlane w kolumnie JustTime. |
Przykład języka VBA
Uwaga: Poniższe przykłady przedstawiają sposób użycia tej funkcji w module języka Visual Basic for Applications (VBA). Aby uzyskać dodatkowe informacje na temat pracy w języku VBA, wybierz pozycję Dokumentacja dewelopera z listy rozwijanej obok przycisku Wyszukaj i wprowadź odpowiednie terminy w polu wyszukiwania.
W tym przykładzie użyto funkcji TimeValue w celu przekonwertowania ciągu na godzinę. Literały dat można również użyć w celu bezpośredniego przypisania godziny do zmiennej typu wariant lub data , na przykład MyTime = #4:35:17 PM#.
Dim MyTime
MyTime = TimeValue("4:35:17 PM") ' Return a time.