Geeft een variant (datum) als resultaat die een datum bevat waaraan een bepaald tijdsinterval is toegevoegd.
Syntaxis
DateAdd(interval, number, date)
De DateAdd functie heeft deze argumenten:
| Argument | Beschrijving |
|---|---|
interval |
Vereist. Een tekenreeksexpressie die het tijdsinterval aangeeft dat u wilt toevoegen. |
number |
Vereist. Een numerieke expressie die het aantal intervallen aangeeft 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. Een variant (datum) of een letterlijke waarde die de datum aangeeft waarbij het interval wordt opgeteld. |
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 bepaald tijdsinterval op te tellen bij of af te trekken van een datum. U kunt DateAdd hiermee bijvoorbeeld berekenen welke datum het is over 30 dagen of hoe laat het is over 45 minuten.
Als u dagen wilt optellen bij 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 wordt 28-Feb-95 als resultaat gegeven, niet 31-Feb-95. Als date dit 31-Jan-96 is, is het resultaat 29-Feb-96 omdat 1996 een schrikkeljaar is.
Als de berekende datum vóór het jaar 100 ligt, wat betekent dat u meer jaren aftrekt dan het aantal jaar waarin dit het geval dateis, treedt er een fout op.
Als een number waarde geen lange waarde is, wordt de waarde afgerond op het dichtstbijzijnde gehele getal voordat de expressie wordt geëvalueerd.
Opmerking
De notatie van de resulterende waarde DateAdd wordt bepaald door Configuratiescherm instellingen, niet door de notatie die wordt doorgegeven in het date argument.
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 bestaan uit namen, moet de naam overeenkomen met de huidige Calendar instelling van de eigenschap. Als u de kans op conflicten wilt verkleinen, voert u numerieke maandwaarden in de korte datumnotatie in.
Queryvoorbeelden
| Expression | Resultaten |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Hiermee wordt 1 jaar opgeteld bij de datumwaarden in het DateofSale veld. |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Hiermee wordt 1 jaar afgetrokken van de datumwaarden in het DateofSale veld. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Hiermee wordt 10 dagen opgeteld bij de datumwaarden in het DateofSale veld en worden de resultaten geretourneerd in de NewDate kolom. |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Hiermee wordt 1 week of 7 dagen afgetrokken van de datumwaarden in het DateofSale veld en worden de resultaten in de NewDate kolom geretourneerd. |
VBA-voorbeeld
Opmerking
In de volgende voorbeelden wordt het gebruik van deze functie in een VBA-module (Visual Basic for Applications) toegelicht. Zie de naslaginformatie over VBA voor Access 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 weer te geven voor een opgegeven aantal maanden in de toekomst.
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