Retourneert een variant (datum) die een datum bevat waaraan een opgegeven tijdsinterval is toegevoegd.
Syntaxis
DateAdd(interval, number, date)
De DateAdd functie heeft deze argumenten:
| Argument | Beschrijving |
|---|---|
interval |
Vereist. Tekenreeksexpressie die het tijdsinterval is dat u wilt toevoegen. |
number |
Vereist. Numerieke expressie die het aantal intervallen is dat u wilt toevoegen. Het kan positief zijn om datums in de toekomst te krijgen of negatief om datums in het verleden te krijgen. |
date |
Vereist. Variant (datum) of letterlijk die de datum aangeeft waaraan het interval wordt toegevoegd. |
Instellingen
Het interval argument heeft deze instellingen:
| Instelling | Omschrijving |
|---|---|
yyyy |
Jaar |
q |
Kwartaal |
m |
maand |
y |
Dag van jaar |
d |
Dag |
w |
Weekdag |
ww |
Week |
h |
Uur |
n |
Minuut |
s |
Seconde |
Opmerkingen
U kunt de DateAdd functie gebruiken om een opgegeven tijdsinterval van een datum toe te voegen of af te trekken. U kunt bijvoorbeeld gebruiken DateAdd om een datum te berekenen die 30 dagen van vandaag is of een tijd van 45 minuten later.
Als u dagen wilt toevoegen aan date, kunt u Dag van het jaar ("y"), Dag ("d") of Weekdag ("w") gebruiken.
De DateAdd functie retourneert geen ongeldige datum. In het volgende voorbeeld wordt één maand opgeteld bij 31 januari:
DateAdd("m", 1, "31-Jan-95")
In dit geval DateAdd retourneert 28-feb-95, niet 31-feb-95. Als date 31-jan-96 is, retourneert het 29-februari-96 omdat 1996 een schrikkeljaar is.
Als de berekende datum voorafgaat aan het jaar 100, wat betekent dat u meer jaren aftrekken dan in date, treedt er een fout op.
Als number geen lange waarde is, wordt deze afgerond op het dichtstbijzijnde gehele getal voordat de expressie wordt geëvalueerd.
Opmerking
De notatie van de retourwaarde voor DateAdd wordt bepaald door Configuratiescherm instellingen, niet door de notatie die in het date argument is doorgegeven.
Opmerking
Als datede instelling van de Calendar eigenschap Gregoriaans is, moet de opgegeven datum Gregoriaans zijn. Als de kalender Hijri is, moet de opgegeven datum de notatie van de Hijri kalender volgen. Als maandwaarden namen zijn, moet de naam overeenkomen met de huidige Calendar eigenschapsinstelling. Als u de kans op conflicten wilt verminderen, voert u numerieke maandwaarden in de notatie Korte datum in.
Queryvoorbeelden
| Expression | Resultaten |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Voegt 1 jaar toe aan de datumwaarden in het DateofSale veld. |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Trekt 1 jaar af van de datumwaarden in het DateofSale veld. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Voegt 10 dagen toe aan de datumwaarden in het DateofSale veld en retourneert de resultaten in de NewDate kolom. |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Trekt 1 week of 7 dagen af van de datumwaarden in het DateofSale veld en retourneert de resultaten in de NewDate kolom. |
VBA-voorbeeld
Opmerking
In de volgende voorbeelden wordt het gebruik van deze functie in een VBA-module (Visual Basic for Applications) toegelicht. Zie Naslaginformatie over VBA openen voor meer informatie over het werken met VBA.
In dit voorbeeld wordt een datum als invoer gebruikt en wordt de DateAdd functie gebruikt om de overeenkomende datum een opgegeven aantal maanden in de toekomst weer te geven.
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