Funktsioon DateAdd

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

Päev aastas

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
Täiendage oma oskusi
Tutvuge koolitusmaterjalidega
Kasutage uusi funktsioone enne teisi
Liituge Office Insideri programmiga

Kas sellest teabest oli abi?

Täname tagasiside eest!

Täname tagasiside eest! Tundub, et võiksime teid kokku viia ühega meie Office'i tugiagentidest, kes aitab teil probleemi lahendada.

×