Tagastab variandi (kuupäeva), mis sisaldab kuupäeva, millele on lisatud määratud intervall.
Süntaks
DateAdd ( interval, number, date )
Funktsiooni DateAdd süntaksil on järgmised argumendid.
|
Argument |
Kirjeldus |
|---|---|
|
interval |
Nõutav. Stringavaldis, mis tähistab ajavahemikku, mida soovite lisada. |
|
number |
Nõutav. Arvuline avaldis, mis tähistab lisatavate intervallide arvu. See võib olla positiivne (tulevikukuupäevade toomiseks) või negatiivne (minevikukuupäevade toomiseks). |
|
date |
Nõutav. Variant (Kuupäev) või sõnaline väärtus, mis tähistab kuupäeva, millele intervall lisatakse. |
Sätted
argument intervallil on järgmised sätted.
|
Säte |
Kirjeldus |
|---|---|
|
yyyy |
Aasta |
|
q |
Kvartal |
|
m |
Kuu |
|
y |
Kuupäev |
|
d |
Päev |
|
w |
Nädalapäev |
|
ww |
Nädal |
|
h |
Tund |
|
n |
Minut |
|
s |
Sekund |
Kommentaarid
Funktsiooni DateAdd abil saab kuupäevale liita määratud ajavahemiku või selle kuupäevast lahutada. Näiteks saate funktsiooni DateAdd kasutada tänasest päevast 30 päeva hilisema kuupäeva või praegusest hetkest 45 minutit hilisema kellaaja arvutamiseks.
Kuupäevale päevade lisamiseks saate kasutada sätet „Päev aastas“ („y) või „Nädalapäev“ („w“).
Funktsioon DateAdd ei tagasta sobimatut kuupäeva. Järgmises näites lisatakse 31. jaanuarile üks kuu:
DateAdd("m", 1, "31-Jan-95")
Praegusel juhul tagastab DateAdd väärtuse 28. veebr 95, mitte 31. veebr 2005. Kui kuupäev on 31. jaanuar 2016, tagastatakse tulem 29. veebr 96, kuna 1996 on liigaasta.
Kui arvutuslik kuupäev on enne aastat 100 (st kui lahutate rohkem aastaid, kui on väärtuses kuupäev), ilmneb tõrge.
Kui argumendi number väärtuseks pole pikk täisarv, ümardatakse see enne arvutamist lähima täisarvuni.
Märkus.: Funktsiooni DateAdd tagastatava väärtuse vorming määratakse juhtpaneeli sätete alusel, mitte argumendis date esitatud vormingu alusel.
Märkus.: Kui argumendi date atribuudi Kalender sätteks on „Gregorius“, peate esitama Gregoriuse kalendri kuupäeva. Islami kalendri korral tuleb kasutada islami kalendri ajaarvestusele vastavat kuupäeva. Kui kuu väärtused on nimed, peavad need olema kooskõlas praeguse atribuudi Kalender sättega. Kuude nimede ja praeguse atribuudi Kalender sätte vaheliste võimalike vastuolude minimeerimiseks sisestage arvulised kuuväärtused (lühike kuupäevavorming).
Päringu näited
|
Avaldis |
Tulemid |
|---|---|
|
SELECT DateAdd("YYYY";1;[DateofSale]) AS Avaldis1 FROM Tootemüük; |
Tagastab tulemid, lisades välja "DateofSale" kuupäevaväärtustele 1 aasta. |
|
SELECT DateAdd("AAAA";-1;[DateofSale]) AS Avaldis1 FROM Tootemüük; |
Tagastab tulemid, lahutades aasta välja "DateofSale" kuupäevaväärtustest. |
|
SELECT DateAdd("d";10;[DateofSale]) AS NewDate FROM ProductSales; |
Tagastab tulemid veerus "UusKuupäev", lisades välja "DateofSale" kuupäevaväärtustele 10 päeva. |
|
SELECT DateAdd("ww";-1;[DateofSale]) AS NewDate FROM ProductSales; |
Tagastab veeru "Uuskuupäev" tulemid, lahutades välja "Kuupäev_kuupäev" kuupäevaväärtustest 1 nädal (7 päeva). |
VBA näide
Märkus.: Järgmised näited kujutavad selle funktsiooni kasutamist rakenduse Visual Basic for Applications (VBA) moodulis. Lisateavet VBA-ga töötamise kohta leiate teemast Accessi VBA teatmematerjalid.
Selles näites kasutatakse kuupäeva sisendina ja funktsiooni DateAdd selleks, et kuvada määratud arvu kuude pärast saabuv vastav kuupäev.
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
