Vrátí hodnotu typu Variant (Date) obsahující datum, ke kterému je přidán zadaný časový interval.
Syntaxe
DateAdd ( interval, číslo, datum )
Syntaxe funkce DateAdd obsahuje následující argumenty:
|
Argument |
Popis |
|
interval |
Povinný argument. Řetězcový výraz představující časový interval, který chcete přidat. |
|
Číslo: |
Povinný argument. Číselný výraz, který je počtem intervalů, které chcete přidat. Může být kladná (k získání dat v budoucnosti) nebo záporná (k získání dat v minulosti). |
|
date |
Povinný argument. Variant(Date)nebo literál představující datum, ke kterému je interval přidán. |
Tip: V Accessu 2010 obsahuje Tvůrce výrazů technologii IntelliSense, takže vidíte, jaké argumenty výraz vyžaduje.
Nastavení
Interval, Argument má tato 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í funkce DateAdd můžete od data sčítat nebo odčítat zadaný časový interval. Pomocí funkce DateAdd můžete například vypočítat datum za 30 dní od dnešního dne nebo od dnešního času 45 minut.
Pokud chcete k datu přidat dny,můžete použít Den roku ("y"), Den ("d") nebo Pracovní den ("w").
Funkce DateAdd nevrátí neplatné datum. Následující příklad přidá k 31. lednu jeden měsíc:
DateAdd("m", 1, "31-Jan-95")
V tomto případě vrátí funkce DateAdd hodnotu 28.02.95, ne 31.2.95. Pokud je datum 31.01.96, vrátí hodnotu 29.02.96, protože rok 1996 je přestupný rok.
Pokud by počítané datum bylo před rokem 100 (to znamená, že odečtete více roků, než je v date),dojde k chybě.
Pokud není hodnota typu Dlouhé číslo, zaokrouhlí se před vyhodnocením na nejbližší celé číslo.
Poznámka: Formát návratové hodnoty pro funkce DateAdd je určen nastavením Ovládacích panelů, nikoli formátem předanutým v argumentu datum.
Poznámka: Pokud jevlastnost Kalendář nastavená na gregoriánský kalendář, musí být zadaným datem gregoriánský kalendář. Pokud je kalendářem kalendář hidžra, musí být zadaným datem kalendář hidžra. Pokud jsou hodnota měsíce názvy, musí být název konzistentní s aktuálním nastavením vlastnosti Kalendář. Pokud chcete minimalizovat možnost, že názvy měsíců budou v konfliktu s nastavením aktuální vlastnosti Kalendář, zadejte číselné hodnoty měsíce (formát Datum (krátké).
Příklady dotazů
|
Výraz |
Výsledky |
|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM Prodej_produktů; |
Vrátí výsledky tak, že k hodnotám dat pole DateofSale přičtete 1 rok. |
|
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM Prodej_produktů; |
Vrátí výsledky odečtením 1 roku od hodnot dat pole DateofSale. |
|
SELECT DateAdd("d";10;[DateofSale]) AS NewDate FROM Prodej_produktů; |
Vrátí výsledky ve sloupci "NewDate" tak, že k hodnotám dat pole DateofSale přičte 10 dnů. |
|
SELECT DateAdd("ww";-1;[DateofSale]) AS NewDate FROM ProductSales; |
Vrátí výsledky ve sloupci "NewDate" odečtením 1 týdne (7 dnů) od hodnot dat pole DateofSale. |
Příklad jazyka VBA
Poznámka: Následující příklady ukazují použití této funkce v modulu VBA (Visual Basic pro Applications). Pokud chcete další informace o práci s modulem VBA, vyberte Referenční informace pro vývojáře, které najdete v rozevíracím seznamu vedle položky Hledat a do vyhledávacího pole napište požadované pojmy.
Tento příklad používá jako vstup datum a pomocí funkce DateAdd 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
