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. |
Näpunäide.: Rakenduses Access 2010 on avaldisekoosturil IntelliSense, mis näitab, milliseid argumente avaldises kasutada tuleb.
Sätted
Argumendil interval 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 liidetakse üks kuu kuupäevale 31. jaanuar.
DateAdd("m", 1, "31-Jan-95")
Antud juhul tagastab DateAdd kuupäeva 28. veebr 1995, mitte 31. veebr 1995. Kui kuupäev on 31. jaan 1996, tagastatakse kuupäev 29. veebr 1996, 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).
Näide
Märkus.: Järgmised näited kujutavad selle funktsiooni kasutamist rakenduse Visual Basic for Applications (VBA) moodulis. Lisateabe saamiseks VBA-ga töötamise kohta valige välja Otsing kõrval kuvatavast ripploendist väärtus Tootearendusmaterjal ja sisestage otsinguväljale üks või mitu sõna.
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
