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

Intervall argument 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 mis ei sobi kuupäevaks. Järgmises näites liidetakse üks kuu jaanuar 31:

DateAdd("m", 1, "31-Jan-95")

Sel juhul tagastab DateAdd 28-veebr-95, mitte 31 veebr 95. Kui kuupäev on 31-jaan-96, tagastab see 29-veebr-96 Kuna 1996 on tavalise aasta.

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

Valige DateAdd("YYYY",1,[DateofSale]) AS Avaldis1 ProductSales;

Tagastab tulemused, lisades 1 aasta kuupäeva väärtused välja "DateofSale".

Valige DateAdd("YYYY",-1,[DateofSale]) AS Avaldis1 ProductSales;

Tagastab tulemused, lahutades 1 aasta kuupäeva väärtused välja "DateofSale".

Valige DateAdd("d",10,[DateofSale]) AS NewDate ProductSales;

Tagastab tulemused, lisades 10 päeva kuupäev väärtused välja "DateofSale" veerus "NewDate".

Valige DateAdd("ww",-1,[DateofSale]) AS NewDate ProductSales;

Tagastab veeru "NewDate" tulemid lahutades nädal (7 päeva) kuupäevaväärtuste välja "DateofSale".

VBA 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

Märkus.:  See leht on tõlgitud automaatselt ning sellel võib leiduda grammatikavigu ja ebatäpsusi. Tahame, et sellest sisust oleks teile abi. Andke meile teada, kui see teave oli teile abiks. Soovi korral saate ingliskeelset artiklit lugeda siit.​

Täiendage Office'i kasutamise 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.

×