Zwraca wartość typu wariant (data) dla określonego roku, miesiąca i dnia.
Składnia
DateSerial(rok, miesiąc, dzień)
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 DateSerial występują następujące argumenty:
| Argumenty argumentów | Opis |
|---|---|
| w roku. | Argument wymagany. Liczba całkowita. Liczba od 100 do 9999 włącznie lub wyrażenie liczbowe. |
| miesiąc | Argument wymagany. Liczba całkowita. Dowolne wyrażenie liczbowe. |
| dzień | Argument wymagany. Liczba całkowita. Dowolne wyrażenie liczbowe. |
Uwagi
Aby określić datę, na przykład 31 grudnia 1991, zakres liczb dla każdego argumentu DateSerial powinien należeć do zakresu akceptowanego dla jednostki; czyli 1–31 dla dni i 1–12 dla miesięcy. Jednak dla każdego argumentu można określić daty względne, używając dowolnego wyrażenia liczbowego reprezentującego pewną liczbę dni, miesięcy lub lat przed określoną datą lub po niej.
W poniższym przykładzie zamiast bezwzględnych liczb daty użyto wyrażeń liczbowych. Funkcja DateSerial zwraca tutaj datę przypadającą na dzień przed pierwszym dniem (1 - 1), dwa miesiące przed sierpniem (8 - 2), 10 lat przed rokiem 1990 (1990 - 10), czyli 31 maja 1980.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Dwucyfrowe lata dla argumentu roku są interpretowane na podstawie ustawień komputera zdefiniowanych przez użytkownika. Domyślne ustawienie jest takie, że wartości od 0 do 29 włącznie są interpretowane jako lata 2000–2029. Wartości domyślne między 30 a 99 są interpretowane jako lata 1930–1999. W przypadku wszystkich innych argumentów dotyczących roku należy użyć roku w formacie czterocyfrowym (na przykład 1800).
Wersje systemu Windows starsze niż Windows 2000 interpretują lata w postaci dwucyfrowej na podstawie wartości domyślnych opisanych powyżej. Aby upewnić się, że funkcja zwraca właściwą wartość, użyj roku w postaci czterocyfrowej.
Gdy którykolwiek argument przekracza dopuszczalny zakres tego argumentu, następuje skok do następnej większej jednostki, stosownie do potrzeb. Jeśli na przykład określisz 35 dni, wartość ta jest szacowana jako jeden miesiąc i pewna liczba dni, w zależności od miejsca w roku, w którym jest stosowana. Jeśli wartość któregokolwiek z argumentów wykracza poza zakres od -32 768 do 32 767, występuje błąd. Jeśli data określona przez trzy argumenty wykracza poza dopuszczalny zakres, występuje błąd.
Uwaga
Dla roku,miesiącaidnia, jeśli ustawienie właściwości Kalendarz jest gregoriańskie, przyjmuje się, że podana wartość jest gregoriańska. Jeśli ustawieniem właściwości Kalendarz jest Hijri, przyjmuje się, że podaną wartością jest Hijri.
Zwracana część daty jest wyrażona w jednostkach okresu bieżącego kalendarza języka Visual Basic. Jeśli na przykład bieżący kalendarz jest kalendarzem Hidżry, a częścią daty, która ma być zwrócona, jest rok, wartość roku jest rokiem kalendarza Hidżry. W przypadku argumentu rok wartości od 0 do 99 włącznie są interpretowane jako lata 1400–1499. W przypadku wszystkich innych wartości roku użyj pełnego czterocyfrowego oznaczenia roku (na przykład 1520).
Przykład zapytania
| Wyrażenie | Rezultat |
|---|---|
| SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales; | Zwraca "datę" dla określonego roku, miesiąca i dnia wprowadzonych w argumentach funkcji i wyświetla w kolumnie "NewDate". Wynik: "13/12/2018". |
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 DateSerial w celu zwrócenia daty dla określonego roku, miesiąca i dnia.
Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.