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 má tyto argumenty:
Argument |
Popis |
---|---|
interval |
Povinný argument. Řetězcový výraz, který je časový interval, který chcete přidat. |
Číslo: |
Povinný argument. Číselný výraz, který představuje počet intervalů, které chcete přidat. Může být pozitivní (získat data v budoucnu) nebo negativní (získat data v minulosti). |
date |
Povinný argument. Varianta (date) nebo literál představující datum, ke kterému je interval přidán. |
Nastavení
IntervalArgument má tato nastavení:
Nastavení |
Popis |
---|---|
yyyy |
Rok |
q |
Čtvrtletí |
m |
Měsíc |
y |
Den v roce |
d |
Den |
w |
Funkce Weekday |
ww |
Týden |
h |
Hodina |
n |
Minuta |
s |
Sekunda |
Poznámky
Pomocí funkce DateAdd můžete přičíst nebo odečíst zadaný časový interval od data. DateAdd můžete například použít k výpočtu data 30 dnů od dnešního dne nebo 45 minut od této chvíle.
Pokud chcete k datu přidat dny, můžete použít Den v roce ("y"), Den ("d") nebo Pracovní den ("w").
Funkce DateAdd nevrátí neplatné datum. Následující příklad přidá jeden měsíc do 31. ledna:
DateAdd("m", 1, "31-Jan-95")
V tomto případě funkce DateAdd vrátí hodnotu 28-Feb-95, nikoli 31-Feb-95. Pokud je datum 31-Jan-96, vrátí 29-Únor-96, protože 1996 je přestupný rok.
Pokud počítané datum předchází roku 100 (tj. odečtete více roků, než je datum), dojde k chybě.
Pokud číslo není hodnota Long, je před vyhodnocením zaokrouhleno na nejbližší celé číslo.
Poznámka: Formát návratové hodnoty pro DateAdd je určen nastavením Ovládacích panelů , nikoli formátem, který je předán v argumentu date .
Poznámka: Pokud je pro datum nastavená vlastnost Kalendář gregoriánský, musí být zadané datum gregoriánské. Pokud je kalendář Hidžra, musí být zadané datum Hidžra. Pokud jsou hodnoty měsíců názvy, musí být název konzistentní s aktuálním nastavením vlastnosti Calendar . Pokud chcete minimalizovat možnost, že by názvy měsíců byly v konfliktu s aktuálním nastavením vlastnosti Kalendář , zadejte číselné hodnoty měsíce (formát krátkého data).
Příklady dotazů
Výraz |
Výsledky |
---|---|
SELECT DateAdd("YYYY";1;[DateofSale]) AS Expr1 FROM ProductSales; |
Vrátí výsledky přidáním 1 roku do hodnot kalendářních dat v poli DateofSale. |
SELECT DateAdd("YYYY";-1;[DateofSale]) AS Expr1 FROM ProductSales; |
Vrátí výsledky odečtením 1 roku od hodnot kalendářních dat v poli DateofSale. |
SELECT DateAdd("d";10;[DateofSale]) AS NewDate FROM ProductSales; |
Vrátí výsledky ve sloupci NewDate přidáním 10 dnů do hodnot kalendářních dat pole DateofSale. |
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 kalendářních 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). Další informace o práci s jazykem VBA najdete v tématu Referenční informace k jazyku VBA.
Tento příklad používá datum jako vstup a používá funkci DateAdd k zobrazení odpovídajícího data zadaného počtu 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