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:
| Argument | Opis |
|---|---|
| Roku | Argument wymagany. Liczba całkowita. Liczba z przedziału 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 znajdować się w zaakceptowanym zakresie jednostki. to jest 1–31 w przypadku dni i od 1 do 12 w przypadku miesięcy. Można jednak określić daty względne dla każdego argumentu przy użyciu dowolnego wyrażenia liczbowego reprezentującego pewną liczbę dni, miesięcy lub lat przed określoną datą lub po tej dacie.
W poniższym przykładzie użyto wyrażeń liczbowych zamiast bezwzględnych liczb dat. W tym miejscu funkcja DateSerial zwraca datę przypadaną na dzień poprzedzający pierwszy dzień (1 - 1), dwa miesiące przed sierpniem (8 - 2), 10 lat przed 1990 r. (1990 - 10czyli 31 maja 1980 r.).
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Argument rok w postaci dwucyfrowej jest interpretowany na podstawie ustawień komputera zdefiniowanych przez użytkownika. Ustawienia domyślne to: wartości z przedziału od 0 do 29 włącznie są interpretowane jako lata 2000–2029. Wartości domyślne z zakresu od 30 do 99 są interpretowane jako lata 1930–1999. We wszystkich pozostałych argumentach roku należy użyć roku czterocyfrowego (na przykład 1800).
Wersje systemu Windows starsze niż Windows 2000 interpretują lata dwucyfrowe na podstawie ustawień domyślnych opisanych powyżej. Aby mieć pewność, że funkcja zwróci właściwą wartość, użyj 4-cyfrowego roku.
Jeśli jakikolwiek argument przekracza zaakceptowany zakres dla tego argumentu, zwiększa się on odpowiednio do następnej większej jednostki. Jeśli na przykład określisz 35 dni, zostanie ono ocenione jako jeden miesiąc i pewna liczba dni, w zależności od tego, gdzie jest stosowany w roku. Jeśli jakikolwiek pojedynczy argument znajduje się poza zakresem od -32 768 do 32 767, występuje błąd. Jeśli data określona przez trzy argumenty wykracza poza dopuszczalny zakres dat, występuje błąd.
Uwaga
W przypadku roku,miesiąca i dnia, jeśli ustawieniem właściwości Calendar jest gregoriański, przyjmuje się, że podanej wartością jest Gregoriański. Jeśli ustawieniem właściwości Calendar jest Hidżry, przyjmuje się, że podanej wartością jest Hidżry.
Zwrócona część daty znajduje się w jednostkach przedziału czasu bieżącego kalendarza języka Visual Basic. Jeśli na przykład bieżącym kalendarzem jest Hidżry, a częścią daty, która ma zostać zwrócona, jest rok, wartość roku to rok Hidżry. W roku argumentacji wartości od 0 do 99, włącznie, są interpretowane jako lata 1400-1499. Dla wszystkich pozostałych wartości roku użyj pełnego czterocyfrowego roku (na przykład 1520).
Przykład kwerendy
| Wyrażenie | Rezultat |
|---|---|
| SELECT Dateserial(2018;12;13) AS NewDate FROM ProductSales; | Zwraca wartość "data" dla określonego roku, miesiąca i dnia wprowadzona w argumentach funkcji i jest wyświetlana w kolumnie "Nowa Data". Wynik: "2018-13-12". |
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 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.