Returnerer en variant (dato), der indeholder en dato med et angivet tidsinterval tilføjet.
Syntaks
DateAdd(interval, number, date)
Funktionen DateAdd har disse argumenter:
| Argument | Beskrivelse |
|---|---|
interval |
Påkrævet. Strengudtryk, der er det tidsinterval, du vil tilføje. |
number |
Påkrævet. Numerisk udtryk, der er det antal intervaller, du vil tilføje. Det kan være positivt at få datoer i fremtiden eller negative for at få datoer i fortiden. |
date |
Påkrævet. Variant (dato) eller konstant, der repræsenterer den dato, intervallet føjes til. |
Indstillinger
Argumentet interval har disse indstillinger:
| Indstilling | Beskrivelse |
|---|---|
yyyy |
År |
q |
Kvartal |
m |
Måned |
y |
Dag i året |
d |
Dag |
w |
Ugedag |
ww |
Uge |
h |
Time |
n |
Minut |
s |
Sekund |
Bemærkninger
Du kan bruge funktionen DateAdd til at addere eller subtrahere et angivet tidsinterval fra en dato. Du kan f.eks. bruge DateAdd til at beregne en dato 30 dage fra i dag eller et klokkeslæt 45 minutter fra nu.
Hvis du vil føje dage til date, kan du bruge Dag i året ("y"), Dag ("d") eller Ugedag ("w").
Funktionen DateAdd returnerer ikke en ugyldig dato. I følgende eksempel føjes en måned til den 31. januar:
DateAdd("m", 1, "31-Jan-95")
I dette tilfælde DateAdd returneres 28-feb-95, ikke 31-feb-95. Hvis date er 31-Jan-96, returneres 29-feb-96, fordi 1996 er et skudår.
Hvis den beregnede dato kommer før år 100, hvilket betyder, at du subtraherer flere år end i date, opstår der en fejl.
Hvis number ikke er en Lang værdi, afrunder Access den til nærmeste hele tal, før udtrykket evalueres.
Bemærk
Formatet for returværdien for DateAdd bestemmes af Kontrolpanel indstillinger, ikke af det format, der overføres i date argumentet.
Bemærk
For date, hvis egenskabsindstillingen Calendar er gregoriansk, skal den angivne dato være gregoriansk. Hvis kalenderen er hijri, skal den angivne dato være hijri. Hvis månedsværdier er navne, skal navnet stemme overens med den aktuelle Calendar egenskabsindstilling. Hvis du vil reducere risikoen for konflikter, skal du angive numeriske månedsværdier i kort datoformat.
Forespørgselseksempler
| Udtryk | Resultater |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Lægger 1 år til datoværdierne i feltet DateofSale . |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Trækker 1 år fra datoværdierne i feltet DateofSale . |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Lægger 10 dage til datoværdierne i feltet DateofSale og returnerer resultaterne i kolonnen NewDate . |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Trækker 1 uge eller 7 dage fra datoværdierne i feltet DateofSale og returnerer resultaterne i NewDate kolonnen. |
VBA-eksempel
Bemærk
Følgende eksempler demonstrerer brugen af denne funktion i et VBA-modul (Visual Basic for Applications). Du kan finde flere oplysninger om at arbejde med VBA i Access VBA-reference.
I dette eksempel bruges en dato som input og funktionen bruges DateAdd til at vise den matchende dato et angivet antal måneder fremover.
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