Vrne podatkovni tip Različica (datum), ki vsebuje datum, kateremu je bil dodan določen časovni interval.
Sintaksa
DateAdd ( interval, število, datum )
Sintaksa funkcije DateAdd ima te argumente:
|
Argument |
Opis |
|---|---|
|
Interval |
Obvezno. Izraz niza, ki je časovni interval, ki ga želite dodati. |
|
Število |
Obvezno. Številski izraz, ki je število intervalov, ki jih želite prišteti. Lahko je pozitiven (če želite dobiti datume za prihodnost) ali negativen (če želite dobiti datume za preteklost). |
|
Datum |
Obvezno. Različica (datum) ali dobesedno besedilo, ki predstavlja datum, kateremu je interval prištet. |
Nastavitve
Interval argument ima te nastavitve:
|
Nastavitev |
Opis |
|---|---|
|
yyyy |
Leto |
|
q |
Četrtletje |
|
m |
Mesec |
|
y |
Dan v letu |
|
d |
Dan |
|
w |
Delovni dan |
|
ww |
Teden |
|
h |
Ura |
|
n |
Minuta |
|
s |
Sekunda |
Opombe
Funkcijo DateAdd lahko uporabite za prištevanje ali odštevanje določenega časovnega intervala od datuma. Funkcijo DateAdd lahko na primer uporabite za izračun datuma, ki je 30 dni od danes ali 45 minut od zdaj.
Če želite datumu prišteti dneve, lahko uporabite dan v letu (»y«), dan (»d«), ali delovni dan (»w«).
Funkcija DateAdd ne bo vrnila neveljavnega datuma. Naslednji primer prišteje 31. januarju en mesec:
DateAdd("m", 1, "31-Jan-95")
V tem primeru funkcija DateAdd vrne 28. februar in ne 31. februar 95. Če je datum 31. januarja 96, vrne 29. februar 1996, ker je leto 1996 prestopno leto.
Če bi bil izračunani datum pred letom 100 (torej bi odšteli več let, kot jih je v datumu), pride do napake.
Če število ni tipa Long, se zaokroži na najbližje celo število pred ovrednotenjem.
Opomba: Oblika zapisa vrnjene vrednosti za funkcijo DateAdd je določena z nastavitvami na nadzorni plošči, in ne glede na obliko zapisa, ki je bila prenesena v argument date.
Opomba: Če je lastnost Calendar nastavljena na gregorijanski, mora biti za datum podan datum gregorijanskega koledarja. Če gre za islamski koledar, mora biti podani datum iz islamskega koledarja. Če so vrednosti mesecev imena, mora biti ime skladno s trenutno nastavitvijo lastnosti Calendar. Da zmanjšate možnost spora imen mesecev s trenutno nastavitvijo lastnosti Calendar, vnesite številske vrednosti mesecev (kratka oblika zapisa za datum).
Primeri poizvedb
|
Izraz |
Rezultati |
|---|---|
|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Vrne rezultate tako, da datumski vrednosti polja »DateofSale« prišteje 1 leto. |
|
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Vrne rezultate tako, da odšteje 1 leto od datumskih vrednosti polja »DateofSale«. |
|
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Vrne rezultate v stolpcu »NewDate« tako, da datumski vrednosti polja »DateofSale« doda 10 dni. |
|
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Vrne rezultate v stolpcu »NewDate« tako, da odšteje 1 teden (7 dni) od datumskih vrednosti polja »DateofSale«. |
primer VBA
Opomba: V spodnjih primerih je prikazana uporaba te funkcije v modulu Visual Basic for Applications (VBA). Če želite več informacij o delu s kodo VBA, glejte Referenca za Access VBA.
V tem primeru je za vnos uporabljen datum in s pomočjo funkcije DateAdd je prikazano, da je ustrezni datum določeno število mesecev v prihodnosti.
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
