Zwraca wartość typu wariant (data) zawierającą czas określonej godziny, minuty i sekundy.
Składnia
TimeSerial(godzina, minuta, sekunda)
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 CzasSzeregowy występują następujące argumenty:
| Argumenty argumentów | Opis |
|---|---|
| godzina | Argument wymagany. Wariant (liczba całkowita). Liczba z zakresu od 0 (godzina 00:00) do 23 (godzina 23:00) włącznie lub wyrażenie liczbowe. |
| minuta | Argument wymagany. Wariant (liczba całkowita). Dowolne wyrażenie liczbowe. |
| sekunda | Argument wymagany. Wariant (liczba całkowita). Dowolne wyrażenie liczbowe. |
Uwagi
Aby określić czas, np. 11:59:59, zakres liczb dla każdego argumentu TimeSerial powinien mieścić się w normalnym zakresie dla danej jednostki. czyli 0–23 dla godzin i 0–59 dla minut i sekund. Jednak dla każdego argumentu można również określić czas względny, używając dowolnego wyrażenia liczbowego reprezentującego pewną liczbę godzin, minut lub sekund przed określoną wartością albo po niej. W poniższym przykładzie zamiast bezwzględnych liczb czasu użyto wyrażeń. Funkcja TimeSerial zwraca czas dla 15 minut przed kropką (),-15 sześć godzin przed południem (12 - 6), czyli 5:45:00.
TimeSerial(12 - 6, -15, 0)
Gdy którykolwiek argument przekracza normalny zakres tego argumentu, następuje skok do następnej większej jednostki, jeśli jest to konieczne. Jeśli na przykład określisz wartość 75 minut, wartość szacowana jest jako jedna godzina i 15 minut. Jeśli wartość któregokolwiek z argumentów wykracza poza zakres od -32 768 do 32 767, występuje błąd. Jeśli czas określony przez trzy argumenty spowoduje, że data wyjdzie poza dopuszczalny zakres, wystąpi błąd.
Przykład zapytania
| Wyrażenie | Rezultat |
|---|---|
| SELECT TimeSerial(18,12,10) AS NewTime FROM ProductSales GROUP BY TimeSerial(18,12,10); | Zwraca wartość "Czas" składającą się z określonej godziny, minuty i sekundy wprowadzonych w argumentach funkcji i wyświetlaną w kolumnie NowyCzas. Wynik: "6:12:10 PM". |
Przykład kodu 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 czasu dla określonej godziny, minuty i sekundy.
Dim MyTime
MyTime = TimeSerial(16, 35, 17)
' MyTime contains serial representation of 4:35:17 PM.