Returnerer en variant (dato) som inneholder en dato der et angitt tidsintervall er lagt til.
Syntaks
DateAdd ( intervall; tall; dato )
Syntaksen for funksjonen DateAdd har følgende argumenter:
|
Argument |
Beskrivelse |
|---|---|
|
intervall |
Obligatorisk. Strenguttrykk som er tidsintervallet du vil legge til. |
|
tall |
Obligatorisk. Numerisk uttrykk som er antall intervaller du vil legge til. Tallet kan være positivt (for å angi datoer i fremtiden) eller negativt (for å angi datoer i fortiden). |
|
dato |
Obligatorisk. Variant (dato) eller litteral som representerer datoen intervallet legges til. |
Innstillinger
Intervallet argument har disse innstillingene:
|
Innstilling |
Beskrivelse |
|---|---|
|
åååå |
År |
|
q |
Kvartal |
|
m |
Måned |
|
y |
Dag i året |
|
d |
Dag |
|
w |
Weekday |
|
ww |
Uke |
|
t |
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 dager til dags dato, kan du bruke dag («y»), dag («d») eller ukedag («w»).
DateAdd-funksjonen returnerer ikke en ugyldig dato. Følgende eksempel legger én måned til 31. januar:
DateAdd("m", 1, "31-Jan-95")
I dette tilfellet returnerer DateAdd 28-februar-95, ikke 31-februar-95. Hvis datoen er 31-jan-96, returnerer den 29-februar-96 fordi 1996 er et skuddår.
Hvis den beregnede datoen kommer før år 100 (det vil si at du trekker fra flere år enn det som er i dato), oppstår det en feil.
Hvis tall ikke er en lang verdi, avrundes det til nærmeste hele tall før det evalueres.
Obs!: Formatet for returverdien for DateAdd bestemmes av Kontrollpanel innstillingene, ikke av formatet som sendes i datoargumentet.
Obs!: For dato, hvis innstillingen for kalenderegenskapen 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 kalenderegenskapsinnstilling. Hvis du vil minimere muligheten for at månedsnavn kommer i konflikt med gjeldende innstilling for kalenderegenskap , skriver du inn numeriske månedsverdier (kort datoformat).
Spørringseksempler
|
Expression |
Resultater |
|---|---|
|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Returnerer resultatene ved å legge til 1 år i datoverdiene i feltet DateofSale. |
|
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Returnerer resultatene ved å trekke 1 år til datoverdiene i feltet DateofSale. |
|
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Returnerer resultatene i kolonnen "NewDate" ved å legge til 10 dager til datoverdiene i feltet "DateofSale". |
|
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Returnerer resultatene i kolonnen "NewDate" ved å trekke 1 uke (7 dager) fra datoverdiene i feltet "DateofSale". |
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 en tilsvarende 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
