Funcția DateAdd

Se aplică la
Access pentru Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Returnează o variantă (dată) care conține o dată cu un interval de timp specificat adăugat.

Sintaxă

DateAdd(interval, number, date)

Funcția 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.
number Obligatoriu. Expresie numerică, adică numărul de intervaluri pe care doriți să le adăugați. Valoarea poate fi pozitivă pentru a obține date din viitor sau negativă pentru a obține date din trecut.
date Obligatoriu. Variant (Dată) sau literal care reprezintă data la care este adăugat intervalul.

Setări

Argumentul interval are aceste setări:

Setare Descriere
yyyy An
q Trimestru
m Lună
y Zi din an
d Zi
w Weekday
ww Săptămână
h Oră
n Minut
s A doua

Observații

Puteți utiliza funcția pentru a aduna sau a scădea un interval de timp specificat dintr-o DateAdd dată. De exemplu, puteți utiliza DateAdd pentru a calcula o dată începând de astăzi cu 30 de zile sau o oră peste 45 de minute.

Pentru a adăuga zile la date, puteți utiliza Ziua din an ("y"), Ziua ("d") sau Ziua săptămânii ("w").

DateAdd Funcția 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ă date este 31 ianuarie-96, returnează 29-feb-96, deoarece 1996 este un an bisect.

Dacă data calculată ar preceda anul 100, ceea ce înseamnă că scădeți mai mulți ani decât în date, se produce o eroare.

Dacă number nu este o valoare lungă, Access o rotunjește la cel mai apropiat număr întreg înainte de a evalua expresia.

Notă

Formatul valorii returnate este DateAdd determinat de setările din Panou de control, nu de formatul transmis argumentuluidate.

Notă

Pentru date, 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 luni sunt nume, numele trebuie să se potrivească cu setarea proprietății curente Calendar . Pentru a reduce posibilitatea conflictelor, introduceți valorile numerice de lună în formatul Dată scurtă.

Exemple de interogare

expresie Rezultatele
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; Adaugă 1 an la valorile dată din DateofSale câmp.
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; Scade 1 an din valorile dată din DateofSale câmp.
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; Adaugă 10 zile la valorile de date din DateofSale câmp și returnează rezultatele în coloană NewDate .
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; Scade 1 săptămână sau 7 zile din valorile de date din DateofSale câmp și returnează rezultatele în NewDate coloană.

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ța Access VBA.

Acest exemplu ia o dată ca intrare și utilizează DateAdd funcția pentru a afișa data potrivită pentru un anumit număr de luni din 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

Consultați și

Alegerea funcției de dată potrivite