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 å 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 å addere eller subtrahere 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 dager i date, kan du bruke Dag i året ("y"), Dag ("d") eller Ukedag ("w").
Funksjonen DateAdd returnerer ikke en ugyldig dato. Følgende eksempel legger til én måned til 31. januar:
DateAdd("m", 1, "31-Jan-95")
I dette tilfellet DateAdd returneres 28-feb-95, ikke 31-feb-95. Hvis date den er 31-Jan-96, returneres den 29-Feb-96 fordi 1996 er et skuddår.
Hvis den beregnede datoen ville vært før år 100, 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, avrunder Access verdien til nærmeste hele tall før uttrykket evalueres.
Obs!
Formatet til returverdien bestemmes av innstillingene i DateAddKontrollpanel, ikke av formatet som brukes i argumentetdate.
Obs!
Hvis dateegenskapsinnstillingen er gregoriansk Calendar , 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 den gjeldende Calendar egenskapsinnstillingen. Hvis du vil redusere sjansen for konflikter, skriver du inn numeriske månedsverdier i Kort datoformat.
Eksempler på spørringer
| Uttrykk | Resultater |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Legger til 1 år til 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 til 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 resultatet 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 Access VBA-referanse.
Dette eksemplet bruker en dato som inndata og bruker DateAdd funksjonen til å vise samsvarsdatoen et angitt antall måneder frem i tid.
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