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
Intervalli 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 sobimatut kuupäeva. Järgmine näide liidab ühe kuu 31.
DateAdd("m", 1, "31-Jan-95")
Sel juhul tagastatakse DateAdd 28-veebr-95, mitte 31-veebr-95. Kui kuupäev on 31-Jan-96, tagastatakse see 29-veebr-96, sest 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 |
|---|---|
|
Valige DateAdd ("YYYY", 1, [DateofSale]), nagu Expr1 FROM ProductSales; |
Annab tulemid tulemiks, liites ühe aasta võrra välja "DateofSale" kuupäeva väärtusteni. |
|
Valige DateAdd ("YYYY",-1, [DateofSale]) nagu Expr1 FROM ProductSales; |
Annab tulemiks tulemid, lahutades ühe aasta võrra välja "DateofSale" kuupäeva väärtustest. |
|
Valige DateAdd ("d", 10, [DateofSale]) NewDate FROM ProductSales; |
Annab tulemuseks tulemid veerus "NewDate", lisades 10 päeva välja "DateofSale" kuupäeva väärtuste kuupäevale. |
|
Valige DateAdd ("ww",-1, [DateofSale]), nagu NewDate FROM ProductSales; |
Annab tulemuseks tulemid veerus "NewDate", lahutades 1 nädal (7 päeva) välja "DateofSale" kuupäeva väärtustest. |
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.
