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 |
|
rok |
Argument wymagany. Liczba całkowita. Liczba z przedziału od 100 do 9999 włącznie lub wyrażenie numeryczne. |
|
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żdegoargumentDateSerial 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. Tutaj funkcja DateSerial zwraca datę przypadaną na dzień przed pierwszym dniem (1 - 1), dwa miesiące przed sierpniem (8 - 2), 10 lat przed 1990 (1990 - 10); innymi słowy, 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 Kalendarz jest gregoriański, przyjmuje się, że podanej wartością jest Gregoriański. Jeśli ustawieniem właściwości Kalendarz 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
|
Expression |
Wyniki |
|
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.
