Returnerer en variant (dato) som inneholder en dato med et angitt tidsintervall lagt til.
Syntaks
DateAdd(interval, number, date)
Funksjonen DateAdd har disse argumentene:
| Argument | Beskrivelse |
|---|---|
interval |
Obligatorisk. Strenguttrykk som er tidsintervallet du vil legge til. |
number |
Obligatorisk. Numerisk uttrykk som er antall intervaller du vil legge til. Det kan være positivt å få datoer i fremtiden eller negativt for å få datoer i fortiden. |
date |
Obligatorisk. Variant (dato) eller litteral som representerer datoen intervallet legges til. |
Innstillinger
Argumentet interval har disse innstillingene:
| Innstilling | Beskrivelse |
|---|---|
yyyy |
År |
q |
Kvartal |
m |
Måned |
y |
Dag i året |
d |
Dag |
w |
Weekday |
ww |
Uke |
h |
Time |
n |
Minutt |
s |
Sekund |
Merknader
Du kan bruke DateAdd funksjonen til å legge til eller trekke fra et angitt tidsintervall fra en dato. Du kan for eksempel bruke DateAdd til å beregne en dato 30 dager fra i dag eller et klokkeslett 45 minutter fra nå.
Hvis du vil legge til datedager i , kan du bruke Dag ("y"), Dag ("d") eller Ukedag ("w").
Funksjonen DateAdd returnerer ikke en ugyldig dato. Følgende eksempel legger én måned til 31. januar:
DateAdd("m", 1, "31-Jan-95")
I dette tilfellet, DateAdd returnerer 28-februar-95, ikke 31-februar-95. Hvis date er 31-jan-96, returnerer den 29-februar-96 fordi 1996 er et skuddår.
Hvis den beregnede datoen kommer før år 100, noe som betyr at du trekker fra flere år enn det som er i date, oppstår det en feil.
Hvis number det ikke er en lang verdi, runder Access av til nærmeste hele tall før uttrykket evalueres.
Obs!
Formatet for returverdien bestemmes DateAdd av Kontrollpanel innstillingene, ikke av formatet som ble sendt i date argumentet.
Obs!
Hvis dateegenskapsinnstillingen for eksempel Calendar er gregoriansk, må den angitte datoen være gregoriansk. Hvis kalenderen er Hijri, må den angitte datoen være Hijri. Hvis månedsverdier er navn, må navnet samsvare med gjeldende Calendar egenskapsinnstilling. Hvis du vil redusere sjansen for konflikter, skriver du inn numeriske månedsverdier i kort datoformat.
Spørringseksempler
| Uttrykk | Resultater |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Legger til 1 år i datoverdiene i feltet DateofSale . |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Trekker 1 år fra datoverdiene i feltet DateofSale . |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Legger til 10 dager i datoverdiene i DateofSale feltet og returnerer resultatene i NewDate kolonnen. |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Trekker 1 uke eller 7 dager fra datoverdiene i DateofSale feltet og returnerer resultatene i NewDate kolonnen. |
VBA-eksempel
Obs!
I eksemplene nedenfor vises bruken av denne funksjonen i en VBA-modul (Visual Basic for Applications). Hvis du vil ha mer informasjon om hvordan du arbeider med VBA, kan du se Referanse for Access VBA.
Dette eksemplet tar en dato som inndata og bruker DateAdd funksjonen til å vise samsvarende dato et angitt antall måneder 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