Vráti hodnotu typu Variant (Date), ktorá obsahuje dátum s pridaným zadaným časovým intervalom.
Syntax
DateAdd(interval, number, date)
Funkcia DateAdd má tieto argumenty:
| Argument | Popis |
|---|---|
interval |
Povinný argument. Reťazcový výraz určujúci časový interval, ktorý chcete pridať. |
number |
Povinný argument. Numerický výraz vyjadrujúci počet intervalov, ktoré chcete pridať. Môže byť kladné na získanie dátumov v budúcnosti alebo negatívne, ak chcete získať dátumy v minulosti. |
date |
Povinný argument. Hodnota typu Variant (Date) alebo explicitná hodnota, ktorá predstavuje dátum, ku ktorému sa pridáva interval. |
Nastavenia
Argument interval má tieto nastavenia:
| Nastavenie | Popis |
|---|---|
yyyy |
Rok |
q |
Štvrťrok |
m |
Mesiac |
y |
Deň v roku |
d |
Deň |
w |
Weekday |
ww |
Týždeň |
h |
Hodina |
n |
Minúta |
s |
Sekunda |
Poznámky:
Funkciu DateAdd môžete použiť na pripočítanie alebo odpočítanie konkrétneho časového intervalu od dátumu. Môžete napríklad vypočítať DateAdd dátum 30 dní odo dnes alebo čas 45 minút odteraz.
Na pridanie dní môžete použiť dateargument Deň v roku ("y"), Deň ("d") alebo Deň v týždni ("w").
Funkcia DateAdd nevráti neplatný dátum. V nasledujúcom príklade sa pripočíta jeden mesiac k dátumu 31. január:
DateAdd("m", 1, "31-Jan-95")
V tomto prípade vráti DateAdd 28. február 1995, nie 31. február 1995. Ak date je to 31. február 1996, vráti sa 29. február 1996, pretože rok 1996 je priestupný.
Ak by vypočítaný dátum bol skôr ako v roku 100, čo znamená, že ste odpočítali viac rokov, ako sa nachádza v , datevyskytne sa chyba.
Ak number zasiahne hodnotu typu Long, Access ju pred vyhodnotením výrazu zaokrúhli na najbližšie celé číslo.
Poznámka
Formát vrátenej hodnoty určujú DateAdd nastavenia ovládacieho panela, nie formát použitý v argumentedate.
Poznámka
Ak dateCalendar je vlastnosť nastavená na možnosť Gregoriánsky, zadaný dátum musí byť podľa gregoriánskeho kalendára. Ak ide o kalendár Hedžra, zadaný dátum musí byť podľa kalendára Hedžra. Ak sú hodnotami mesiaca názvy, názov sa musí zhodovať s aktuálnym nastavením Calendar vlastnosti. Ak chcete znížiť pravdepodobnosť konfliktov, zadávajte číselné hodnoty mesiacov v krátkom formáte dátumu.
Príklady dotazov
| Výraz | Výsledky |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Pripočíta k hodnotám dátumu v DateofSale poli 1 rok. |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Odpočíta od hodnôt dátumu v DateofSale poli 1 rok. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Pripočíta k dátumovým hodnotám v DateofSale poli 10 dní a vráti výsledky v stĺpci.NewDate |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Odpočíta od hodnôt dátumu v DateofSale poli 1 týždeň alebo 7 dní a vráti výsledky v NewDate stĺpci. |
Príklad VBA
Poznámka
Nasledujúce príklady ukazujú použitie tejto funkcie v module jazyka Visual Basic for Applications (VBA). Ďalšie informácie o práci s jazykom VBA nájdete v referenčných informáciách k jazyku VBA programu Access.
V tomto príklade sa dátum považuje za vstup a funkcia sa DateAdd používa na zobrazenie zodpovedajúceho dátumu o určitý počet mesiacov v budúcnosti.
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