Tagastab variandi (kuupäeva), mis sisaldab määratud ajaintervalliga kuupäeva.
Süntaks
DateAdd(interval, number, date)
Funktsioonil DateAdd on järgmised argumendid.
| Argument | Kirjeldus |
|---|---|
interval |
Nõutav. Stringavaldis, mis tähistab ajavahemikku, mille soovite lisada. |
number |
Nõutav. Arvuline avaldis, mis tähistab lisatavate intervallide arvu. Kuupäevade toomiseks minevikus võib olla positiivne kuupäev või negatiivne. |
date |
Nõutav. Variant (Kuupäev) või sõnasõnaline väärtus, mis tähistab kuupäeva, millele intervall lisatakse. |
Sätted
Argumendil interval on järgmised sätted.
| Säte | Kirjeldus |
|---|---|
yyyy |
Year (aasta) |
q |
Quarter (kvartal) |
m |
Month (kuu) |
y |
Kuupäev |
d |
Day (päev) |
w |
Weekday |
ww |
Week (nädal) |
h |
Tund |
n |
Minut |
s |
Sekund |
Kommentaarid
Selle funktsiooni abil DateAdd saate liita või lahutada kuupäevast määratud ajaintervalli. Näiteks saate arvutada DateAdd kuupäeva, mis on 30 päeva tänasest päevast või 45 minutit alates tänasest.
I-le datepäevade lisamiseks saate kasutada suvandit Aastapäev ("y"), Päev ("d") või Tööpäeva ("w").
Funktsioon DateAdd ei tagasta sobimatut kuupäeva. Järgmises näites lisatakse 31. jaanuarile üks kuu:
DateAdd("m", 1, "31-Jan-95")
Sel juhul DateAdd tagastab tulemeid 28. veebr 2015, mitte 31. veebruar 2005. Kui date on 31. jaanuar 96, tagastab see väärtuse 29. veebruar 96, kuna 1996 on liigaasta.
Kui arvutuslik kuupäev eelneks aastale 100, mis tähendab, et lahutate rohkem aastaid kui argumendis dateon , ilmneb tõrge.
Kui number see pole pikk täisarv, ümardab Access selle lähima täisarvuni, enne kui see avaldist väärtustab.
Märkus.
Tagastusväärtuse DateAdd vormingu määravad Juhtpaneel sätted, mitte argumendis date esitatud vorming.
Märkus.
Calendar Kui dateatribuudi sätteks on "Gregoriuse", peab sisestatud kuupäev olema Gregoriuse gregoriuse täht. Islami kalendri korral tuleb kasutada islami ajaarvestusele vastavat kuupäeva. Kui kuu väärtused on nimed, peab nimi vastama praegusele Calendar atribuudisättele. Konfliktide vähendamiseks sisestage arvulised kuuväärtused lühikeses kuupäevavormingus.
Päringu näited
| Avaldis | Tulemid |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Liidab välja kuupäevaväärtustele DateofSale 1 aasta. |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Lahutab välja kuupäevaväärtustest DateofSale 1 aasta. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Liidab välja kuupäevaväärtustele DateofSale 10 päeva ja tagastab tulemid veerus NewDate . |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Lahutab välja kuupäevaväärtustest DateofSale 1 nädal ehk 7 päeva ja tagastab tulemid veerus NewDate . |
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 sisendina kuupäeva ja funktsiooni abil DateAdd kuvatakse vastenduskuupäevaga määratud arv kuid tulevikus.
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