Vrátí hodnotu typu Variant (Date) obsahující datum se zadaným časovým intervalem.
Syntaxe
DateAdd(interval, number, date)
Funkce DateAdd má tyto argumenty:
| Argument | Popis |
|---|---|
interval |
Povinný argument. Řetězcový výraz představující časový interval, který chcete přidat. |
number |
Povinný argument. Číselný výraz představující počet intervalů, které chcete přidat. Pokud chcete získat data v budoucnosti, může to být záporné. |
date |
Povinný argument. Proměnná (Date) nebo literál představující datum, ke kterému je interval přidáván. |
Nastavení
Argument interval má následující nastavení:
| Nastavení | Popis |
|---|---|
yyyy |
Rok |
q |
Čtvrtletí |
m |
Měsíc |
y |
Den roku |
d |
Den |
w |
Funkce Weekday |
ww |
Týden |
h |
Hodina |
n |
Minuta |
s |
Sekunda |
Poznámky
Pomocí této DateAdd funkce můžete přičíst nebo odečíst zadaný časový interval od určitého data. Můžete DateAdd ho použít třeba k výpočtu data za 30 dnů ode dneška nebo času za 45 minut.
Pokud chcete přidat dny k date, můžete použít Den v roce ("y"), Den ("d") nebo Den v týdnu ("w").
Funkce DateAdd nevrátí neplatné datum. Následující příklad přičte k 31. lednu jeden měsíc:
DateAdd("m", 1, "31-Jan-95")
V tomto případě DateAdd vrátí hodnotu 28. únor 95, ne 31. únor 95. Pokud date je 31. leden 96, vrátí 29. únor 96, protože rok 1996 je přestupný.
Pokud by vypočítané datum předcházelo roku 100, což znamená, že odečítáte více roků, než je ve v date, dojde k chybě.
Pokud number se nejedná o hodnotu typu Long, zaokrouhlí ji Access před vyhodnocením výrazu na nejbližší celé číslo.
Poznámka
Formát návratové hodnoty pro DateAdd je určen nastavením v Ovládacích panely, nikoli formátem předaným v date argumentu.
Poznámka
Pro date, pokud je nastavení vlastnosti gregoriánské Calendar , musí být zadané datum gregoriánského. Pokud je kalendář hidžra, zadané datum musí být hidžra. Pokud jsou hodnoty měsíců názvy, musí název odpovídat aktuálnímu Calendar nastavení vlastnosti. Abyste snížili pravděpodobnost konfliktů, zadávejte číselné hodnoty měsíců ve formátu Datum (krátké).
Příklady dotazů
| Výraz | Výsledky: |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Přidá k hodnotám kalendářních dat v poli DateofSale 1 rok. |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Odečte 1 rok od hodnot kalendářních dat v DateofSale poli. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Přidá k hodnotám kalendářních dat v DateofSale poli 10 dní a vrátí výsledky ve NewDate sloupci. |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Odečte 1 týden nebo 7 dní od hodnot kalendářních dat v DateofSale poli a vrátí výsledky ve sloupci NewDate . |
Příklad jazyka VBA
Poznámka
Následující příklady ukazují použití této funkce v modulu VBA (Visual Basic pro Applications). Další informace o práci s modulem VBA najdete v referenčních informacích k jazyku VBA pro Access.
Tento příklad používá jako vstupní data datum a pomocí DateAdd této funkce zobrazí odpovídající datum o zadaný počet měsíců v budoucnosti.
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