Zwraca wartość typu wariant (data).
Składnia
DateValue(data)
Wymagany argument datyjest zwykle wyrażeniem ciągu reprezentującym datę od 1 stycznia 100 do 31 grudnia 9999. Jednak data może być dowolnym wyrażeniem, które może reprezentować datę, godzinę lub datę i godzinę w tym zakresie.
Uwagi
Jeśli data jest ciągiem zawierającym tylko liczby rozdzielone prawidłowymi separatorami dat, funkcja DateValue rozpoznaje kolejność miesięcy, dni i lat zgodnie z formatem Data krótka określonym dla systemu. Funkcja DateValue rozpoznaje również jednoznaczne daty zawierające nazwy miesięcy w postaci długiej lub skróconej. Na przykład oprócz rozpoznawania dat 12/30/1991 i 12/30/91, DateValue rozpoznaje również 30 grudnia 1991 i 30 grudnia 1991.
Jeśli część daty roku zostanie pominięta, funkcja DateValue użyje bieżącego roku z daty systemowej komputera.
Jeśli argument data zawiera informacje o godzinie, funkcja DateValue nie zwraca wartości. Jeśli jednak data zawiera nieprawidłowe informacje o godzinie (na przykład "89:98"), występuje błąd.
Uwaga
Na dzień, jeśli ustawieniem właściwości Calendar jest gregoriański, podanej datą musi być gregoriański. Jeśli kalendarz to Hidżry, podana data musi mieć wartość Hidżry. Jeśli podanej datą jest Hidżry, datą argumentu jest ciąg reprezentujący datę od 1/1/100 (gregoriański 2 sierpnia 718) do 3/04-9666 (gregoriański 31 grudnia 9999).
Przykłady zapytań
| Wyrażenie | Rezultat |
|---|---|
| SELECT DateValue([DateTime]) AS Expr1 FROM ProductSales; | Zwraca wartości dat pola "DateTime" w formacie Data krótka bez informacji o godzinie. |
| SELECT DateValue([DateTime]) AS NewDate, Count(ProductSales.DateTime) AS CountOfDateTime FROM ProductSales GROUP BY DateValue([DateTime]); | Zwraca wartości dat pola "DateTime" w formacie Data krótka bez informacji o godzinie. |
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 DateValue w celu przekonwertowania ciągu na datę. Przy użyciu literałów dat można także bezpośrednio przypisać datę do zmiennej typu Wariant lub Data , na przykład MyDate = #2012-02-12#.
Dim MyDate
MyDate = DateValue("February 12, 1969") ' Return a date.