Geeft een variant (datum) als resultaat die een datum bevat waarbij een bepaald tijdsinterval is opgeteld.
Syntaxis
DateAdd ( interval, getal, datum )
De syntaxis van de functie DateAdd bevat deze argumenten:
|
Argument |
Beschrijving |
|---|---|
|
interval |
Vereist. Een tekenreeksexpressie die het tijdsinterval aangeeft dat u wilt toevoegen. |
|
getal |
Vereist. Een numerieke expressie die het aantal intervallen aangeeft dat u wilt toevoegen. Dit kan een positief getal zijn (voor datums in de toekomst) of een negatief getal (voor datums in het verleden). |
|
datum |
Vereist. Variant (Datum) of een letterlijke waarde die de datum aangeeft waarbij het interval wordt opgeteld. |
Instellingen
Het intervalargument heeft de volgende instellingen:
|
Instelling |
Beschrijving |
|---|---|
|
jjjj |
Jaar |
|
k |
Kwartaal |
|
m |
Maand |
|
j |
Dag van jaar |
|
d |
Dag |
|
w |
Weekdag |
|
ww |
Week |
|
h |
Uur |
|
N |
Minuut |
|
s |
Seconde |
Opmerkingen
U kunt de functie DateAdd gebruiken om een bepaald tijdsinterval op te tellen bij of af te trekken van een datum. U kunt met DateAdd bijvoorbeeld berekenen welke datum het is over 30 dagen of hoe laat het is over 45 minuten.
Als u dagen wilt optellen bij datum, kunt u dag van het jaar ('y'), dag ('d') of weekdag ('w') gebruiken.
De functie DateAdd retourneert geen ongeldige datum. In het volgende voorbeeld wordt één maand opgeteld bij 31 januari:
DateAdd("m", 1, "31-Jan-95")
In dit geval retourneert DateAdd 28-Feb-95, niet 31-Feb-95. Als datum is ingesteld op 31-Jan-96, is het resultaat 29-Feb-96 omdat 1996 een schrikkeljaar is.
Als de berekende datum vóór het jaar 100 ligt (u trekt dus meer jaren af dan dat er aanwezig zijn in datum), treedt er een fout op.
Als getal geen lange waarde is, wordt de waarde afgerond op het dichtstbijzijnde gehele getal voordat het wordt geëvalueerd.
Opmerking: De indeling van de retourwaarde voor DateAdd wordt bepaald door instellingen in het Configuratiescherm, niet door de notatie die wordt doorgegeven met het argument datum.
Opmerking: Als de eigenschap Calendar voor datum is ingesteld op Gregoriaans, moet de opgegeven datum de Gregoriaanse kalender volgen. 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 instelling van de eigenschap Calendar. U beperkt de kans dat maandnamen niet overeenkomen met de huidige instelling van de eigenschap Calendar door numerieke maandwaarden (korte datumnotatie) in te voeren.
Queryvoorbeelden
|
Expression |
Resultaten |
|---|---|
|
SELECT DateAdd("JJJJ",1,[DateofSale]) AS Expr1 FROM ProductVerkoop; |
Retourneert de resultaten door 1 jaar toe te voegen aan de datumwaarden van het veld 'DateofSale'. |
|
SELECT DateAdd("JJJJ",-1,[DateofSale]) AS Expr1 FROM ProductVerkoop; |
Retourneert de resultaten door 1 jaar af te trekken van de datumwaarden van het veld 'DateofSale'. |
|
SELECT DateAdd("d",10;[DateofSale]) AS NewDate FROM ProductVerkoop; |
Retourneert de resultaten in de kolom 'NewDate' door 10 dagen toe te voegen aan de datumwaarden van het veld 'DateofSale'. |
|
SELECT DateAdd("ww";-1;[DateofSale]) AS NewDate FROM ProductVerkoop; |
Retourneert de resultaten in kolom 'NewDate' door 1 week (7 dagen) af te trekken van de datumwaarden van het veld 'DateofSale'. |
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 via de functie DateAdd de overeenkomende datum weergegeven voor het 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
