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 negativt at få datoer i fortiden. |
date |
Påkrævet. Variant (Dato) eller konstant, der repræsenterer den dato, som intervallet føjes til. |
Indstillinger
Argumentet interval har følgende 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 tidspunkt 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 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 trækker flere år fra, end der er i date, opstår der en fejl.
Hvis number der ikke er en lang værdi, afrunder Access værdien til det nærmeste hele tal, før udtrykket evalueres.
Bemærk
Formatet for returværdien bestemmes af indstillingerne i Kontrolpanelet og DateAdd ikke af det format, der videregives i argumentetdate.
Bemærk
For date, hvis egenskaben 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.
Eksempler på forespørgsel
| Udtryk | Resultater |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Lægger 1 år til datoværdierne i DateofSale feltet. |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Trækker 1 år fra datoværdierne i DateofSale feltet. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Lægger 10 dage til datoværdierne i DateofSale feltet og returnerer NewDate resultaterne i kolonnen. |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Trækker 1 uge eller 7 dage fra datoværdierne i DateofSale feltet 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 anvendes en dato som input og funktionen DateAdd bruges til at få vist den matchende dato et angivet antal måneder ud i fremtiden.
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