Returnerer en variant (dato), der indeholder en dato, som et angivet tidsinterval er føjet til.
Syntaks
DateAdd ( interval, tal, dato )
Syntaksen for funktionen DateAdd har disse argumenter:
|
Argument |
Beskrivelse |
|---|---|
|
interval |
Påkrævet. Strengudtryk, der er det tidsinterval, du vil tilføje. |
|
number |
Obligatorisk. Numerisk udtryk, der er det antal intervaller, du vil tilføje. Det kan være positivt (at få datoer i fremtiden) eller negativt (for at få datoer i fortiden). |
|
date |
Påkrævet. Variant (dato) eller konstant, der repræsenterer den dato, intervallet føjes til. |
Indstillinger
Der er følgende indstillinger for intervalargument:
|
Indstilling |
Beskrivelse |
|---|---|
|
åååå |
År |
|
k |
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 dags dato eller et klokkeslæt 45 minutter fra nu.
Hvis du vil lægge dage til dato, 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 returnerer DateAdd 28-feb-95, ikke 31-feb-95. Hvis dato er 31-Jan-96, returneres 29-feb-96, fordi 1996 er et skudår.
Hvis den beregnede dato kommer før år 100 (dvs. du subtraherer flere år, end der er i dato), opstår der en fejl.
Hvis tal ikke er en Lang værdi, afrundes det til nærmeste hele tal, før det evalueres.
Bemærk!: Formatet af returværdien for DateAdd bestemmes af Kontrolpanel indstillinger, ikke af det format, der overføres i argumentet dato.
Bemærk!: For dato skal den angivne dato være gregoriansk, hvis egenskabsindstillingen Kalender er gregoriansk. Hvis kalenderen er hijri, skal den angivne dato være hijri. Hvis månedsværdier er navne, skal navnet være i overensstemmelse med den aktuelle egenskabsindstilling for Kalender . Hvis du vil minimere risikoen for, at månedsnavne er i konflikt med den aktuelle egenskabsindstilling for Kalender , skal du angive numeriske månedsværdier (kort datoformat).
Forespørgselseksempler
|
Udtryk |
Resultater |
|---|---|
|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Udtryk1 FROM ProductSales; |
Returnerer resultaterne ved at lægge 1 år til datoværdierne i feltet "DateofSale". |
|
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Udtryk1 FROM ProductSales; |
Returnerer resultaterne ved at subtrahere 1 år til datoværdierne i feltet "DateofSale". |
|
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Returnerer resultaterne i kolonnen "NewDate" ved at lægge 10 dage til datoværdierne i feltet "DateofSale". |
|
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Returnerer resultaterne i kolonnen "NewDate" ved at trække 1 uge (7 dage) fra datoværdierne i feltet "DateofSale". |
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 DateAdd bruges til at vise en tilsvarende 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
