Returnează o valoare variant (Dată) care conține o dată la care s-a adăugat un interval de timp specificat.
Sintaxă
DateAdd ( interval, număr, dată )
Sintaxa funcției DateAdd are următoarele argumente:
Argument |
Descriere |
---|---|
interval |
Obligatoriu. Expresie șir care este intervalul de timp pe care doriți să-l adăugați. |
număr |
Obligatoriu. Expresie numerică care este numărul de intervale pe care doriți să le adăugați. Poate fi pozitiv (pentru a obține date în viitor) sau negativ (pentru a obține date din trecut). |
date |
Obligatoriu. Variant (Dată) sau literal, reprezentând data la care este adăugat intervalul. |
Setări
Intervalul argument are aceste setări:
Setare |
Descriere |
---|---|
yyyy |
An |
q |
Trimestru |
m |
Lună |
y |
Ziua din an |
d |
Zi |
w |
Weekday |
ww |
Săptămână |
h |
Oră |
n |
Minut |
s |
Secundă |
Observații
Puteți utiliza funcția DateAdd pentru a aduna sau a scădea un interval de timp specificat dintr-o dată. De exemplu, puteți utiliza DateAdd pentru a calcula o dată de 30 de zile începând de astăzi sau o oră de peste 45 de minute.
Pentru a adăuga zile la dată, puteți utiliza Ziua anului ("y"), Ziua ("d") sau Ziua săptămânii ("w").
Funcția DateAdd nu va returna o dată nevalidă. Următorul exemplu adaugă o lună la 31 ianuarie:
DateAdd("m", 1, "31-Jan-95")
În acest caz, DateAdd returnează 28-feb-95, nu 31-feb-95. Dacă data este 31 ian 96, ea întoarce 29-feb-96, deoarece 1996 este un an bisect.
Dacă data calculată ar preceda anul 100 (adică scădeți mai mulți ani decât în dată), apare o eroare.
Dacă număr nu este o valoare Lungă, este rotunjită la cel mai apropiat număr întreg înainte de a fi evaluat.
Notă: Formatul valorii returnate pentru DateAdd este determinat de setările din Panoul de control , nu de formatul transmis în argumentul dată .
Notă: Pentru dată, dacă setarea proprietății Calendar este gregorian, data furnizată trebuie să fie gregorian. Dacă calendarul este Hijri, data furnizată trebuie să fie Hijri. Dacă valorile lunilor sunt nume, numele trebuie să fie consistent cu setarea curentă a proprietății Calendar . Pentru a minimiza posibilitatea ca numele lunilor să intre în conflict cu setarea curentă a proprietății Calendar , introduceți valorile lunilor numerice (format Dată scurtă).
Exemple de interogare
Expresie |
Rezultatele |
---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Returnează rezultatele adăugând 1 an la valorile dată ale câmpului "DateofSale". |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Returnează rezultatele scăzând 1 an la valorile dată ale câmpului "DateofSale". |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Returnează rezultatele din coloana "Dată NewDate" adăugând 10 zile la valorile dată ale câmpului "DateofSale". |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Returnează rezultatele din coloana "Dată NewDate" scăzând 1 săptămână (7 zile) din valorile de dată ale câmpului "DateofSale". |
Exemplu VBA
Notă: Exemplele care urmează demonstrează utilizarea acestei funcții într-un modul Visual Basic for Applications (VBA). Pentru mai multe informații despre lucrul cu VBA, consultați Referințe VBA Access.
Acest exemplu ia o dată ca intrare și utilizează funcția DateAdd pentru a afișa o dată corespunzătoare un număr specificat de luni în viitor.
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