Zwraca wartość typu wariant (data) zawierającą datę, do której dodano określony interwał.
Składnia
DateAdd(interwał, liczba, data)
W składni funkcji DateAdd występują następujące argumenty:
| Argument | Opis |
|---|---|
| Interwał | Argument wymagany. Wyrażenie ciągu będące interwałem czasu, który chcesz dodać. |
| number | Argument wymagany. Wyrażenie liczbowe będące liczbą interwałów, które chcesz dodać. Może to być dodatnie (aby uzyskać daty w przyszłości) lub ujemne (aby uzyskać daty w przeszłości). |
| Data | Argument wymagany. Wariant (data) lub literał reprezentujący datę, do której jest dodawany interwał. |
Ustawienia
Argument interwałuma następujące ustawienia:
| Ustawienie | Opis |
|---|---|
| rrrr | Rok |
| q | Kwartał |
| m | Miesiąc |
| y | Dzień roku |
| d | Dzień |
| w | Weekday |
| ww | Tydzień |
| g | Godzina |
| n | Minuta |
| s | Sekunda |
Uwagi
Za pomocą funkcji DateAdd można dodać lub odjąć określony interwał czasu od daty. Za pomocą funkcji DateAdd można na przykład obliczyć datę 30 dni od dnia dzisiejszego lub godzinę za 45 minut.
Aby dodać dni do daty, możesz użyć funkcji Dzień Roku ("y"), Dzień ("d") lub Dzień tygodnia ("w").
Funkcja DateAdd nie zwróci nieprawidłowej daty. W poniższym przykładzie do 31 stycznia dodano jeden miesiąc:
DateAdd("m", 1, "31-Jan-95")
W tym przypadku funkcja DateAdd zwraca wartość 28 lutego 95, a nie 31 lutego 95. Jeśli data to 31 sty 96, zwraca wartość 29-lut-96, ponieważ rok 1996 jest rokiem przestępnym.
Jeśli data obliczeniowa poprzedza rok 100 (to oznacza, że odejmujesz więcej lat niż jest w dacie), występuje błąd.
Jeśli argument liczba nie jest wartością typu Liczba długa, przed obliczeniem jest zaokrąglany do najbliższej liczby całkowitej.
Uwaga
Format zwracanej wartości dla funkcji DateAdd jest określany na podstawie ustawień Panel sterowania, a nie na podstawie formatu przekazanego w arguencie data.
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 wartości miesięcy to nazwy, nazwa musi być zgodna z bieżącym ustawieniem właściwości Calendar. Aby zminimalizować możliwość wystąpienia konfliktów nazw miesięcy z bieżącym ustawieniem właściwości Calendar, wprowadź wartości liczbowe miesięcy (format Data krótka).
Przykłady zapytań
| Wyrażenie | Rezultat |
|---|---|
| SELECT DateAdd("RRRR";1;[DateofSale]) AS Wyr1 FROM ProductSales; | Zwraca wyniki, dodając rok do wartości dat pola "DateofSale". |
| SELECT DateAdd("RRRR";-1;[DateofSale]) AS Wyr1 FROM ProductSales; | Zwraca wyniki, odejmując rok od wartości dat pola "DateofSale". |
| SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; | Zwraca wyniki w kolumnie "NewDate", dodając 10 dni do wartości dat pola "DateofSale". |
| SELECT DateAdd("ww";-1;[DateofSale]) AS NewDate FROM ProductSales; | Zwraca wyniki w kolumnie "NewDate", odejmując tydzień (7 dni) od wartości dat pola "DateofSale". |
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ć więcej informacji na temat pracy z językiem VBA, zobacz Dokumentacja języka VBA w programie Access.
Ten przykład przyjmuje datę jako dane wejściowe i używa funkcji DateAdd w celu wyświetlenia odpowiedniej daty o określonej liczbie miesięcy w przyszłości.
Dim FirstDate As Date ' Declare variables.
Dim IntervalType As String
Dim Number As Integer
Dim Msg
IntervalType = "m" ' "m" specifies months as interval.
FirstDate = InputBox("Enter a date")
Number = InputBox("Enter number of months to add")
Msg = "New date: " & _
DateAdd(IntervalType, Number, FirstDate)
MsgBox Msg