Zwraca wartość typu wariant (data) zawierającą czas określonej godziny, minuty i sekundy.
Składnia
TimeSerial ( hour, minute, second )
Ostrzeżenie Upewnij się, że argumenty znajdują się w prawidłowym zakresie wartości. Nieprawidłowy argument może spowodować nieprawidłowy wynik.
W składni funkcji TimeSerial występują następujące argumenty:
Argument |
Opis |
godzina |
Argument wymagany. Wariant (liczba całkowita). Liczba między godziną 0 (12:00) a 23 (23:00), włącznie lub wyrażenie numeryczne. |
Minut |
Argument wymagany. Wariant (liczba całkowita). Dowolne wyrażenie liczbowe. |
Drugi |
Argument wymagany. Wariant (liczba całkowita). Dowolne wyrażenie liczbowe. |
Uwagi
Aby określić godzinę, na przykład 11:59:59, zakres liczb dla każdego argumentu TimeSerial powinien znajdować się w normalnym zakresie jednostki. to jest 0–23 w przypadku godzin i 0–59 w minutach i sekundach. Można jednak określić względne godziny dla każdego argument przy użyciu dowolnego wyrażenia liczbowego reprezentującego określoną liczbę godzin, minut lub sekund przed określoną godziną lub po tej dacie. W poniższym przykładzie użyto wyrażeń zamiast liczb bezwzględnych czasu. Funkcja TimeSerial zwraca godzinę 15 minut przed (-15) sześć godzin przed południem (12 - 6) lub 5:45:00.
TimeSerial(12 - 6, -15, 0)
Jeśli jakikolwiek argument przekracza normalny zakres dla tego argumentu, zwiększa się on odpowiednio do następnej większej jednostki. Jeśli na przykład zostanie określona wartość 75 minut, zostanie ona oceniona jako godzina i 15 minut. Jeśli jakikolwiek pojedynczy argument znajduje się poza zakresem od -32 768 do 32 767, występuje błąd. Jeśli czas określony przez trzy argumenty powoduje, że data nie mieści się w dopuszczalnym zakresie dat, występuje błąd.
Przykład kwerendy
Expression |
Wyniki |
SELECT TimeSerial(18,12,10) AS NewTime FROM ProductSales GROUP BY TimeSerial(18,12,10); |
Zwraca wartość "Godzina" składającą się z określonej godziny, minuty i sekundy wprowadzonej w argumentach funkcji i wyświetlaną w kolumnie NewTime. Wynik: "18:12:10". |
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 TimeSerial w celu zwrócenia godziny dla określonej godziny, minuty i sekundy.
Dim MyTime
MyTime = TimeSerial(16, 35, 17) ' MyTime contains serial representation of 4:35:17 PM.