Atgriež Variant (Date) vērtību ar datumu, kuram pievienots noteikts laika intervāls.
Sintakse
DateAdd(intervāls, skaitlis, datums)
Funkcijas DateAdd sintaksei ir šādi argumenti:
| Arguments | Apraksts |
|---|---|
| intervāls | Obligāts arguments. Virknes izteiksme, kas ir pievienojamais laika intervāls. |
| skaitlis | Obligāts. Skaitliska izteiksme, kas ir pievienojamo intervālu skaits. Tas var būt pozitīvs (lai iegūtu datumus nākotnē) vai negatīvs (lai iegūtu datumus pagātnē). |
| datums | Obligāts arguments. Variants (datums) vai precīzs datums, līdz kuram pievienots intervāls. |
Iestatījumi
Intervālaargumentam ir šādi iestatījumi:
| Iestatījums | Apraksts |
|---|---|
| gggg | Gads |
| q | Ceturksnis |
| m | Mēnesis |
| y | Gada diena |
| d | Diena |
| w | Weekday |
| ww | Nedēļa |
| h | Stunda |
| n | Minūte |
| s | Sekunde |
Piezīmes
Varat izmantot funkciju DateAdd , lai datumam pieskaitītu vai atņemtu noteiktu laika intervālu. Piemēram, varat izmantot DateAdd , lai aprēķinātu datumu, kas seko 30 dienām no šodienas, vai laiku, kas seko 45 minūtēm.
Lai datumam pievienotu dienas, varat izmantot Day of Year ("y"), Day ("d") vai Weekday ("w").
Funkcija DateAdd neatgriež nederīgu datumu. Šajā piemērā 31. janvārim tiek pievienots viens mēnesis:
DateAdd("m", 1, "31-Jan-95")
Šajā gadījumā DateAdd atgriež 28-Feb-95, nevis 31-Feb-95. Ja datums ir 96. gada 31. janvāris, tiek atgriezts 96. gada 29. februāris, jo 1996. gads ir garais gads.
Ja aprēķinātais datums ir pirms gada 100 (t.i., tiek atņemts vairāk gadu nekā datumā), rodas kļūda.
Ja skaitlis nav garā vērtība, tas pirms novērtēšanas tiek noapaļots līdz tuvākajam veselajam skaitlim.
Piezīme
DateAdd atgrieztās vērtības formātu nosaka vadības paneļa iestatījumi, nevis datuma argumentā norādītais formāts.
Piezīme
Ja datuma rekvizīta Calendar iestatījums ir Gregora kalendārs, norādītajam datumam ir jābūt Gregora kalendāra. Ja kalendārs ir Hidžras, norādītajam datumam jābūt Hidžras. Ja mēnešu vērtības ir nosaukumi, nosaukumam jāatbilst pašreizējam rekvizīta Calendar iestatījumam. Lai samazinātu iespēju, ka mēnešu nosaukumi var konfliktēt ar pašreizējo rekvizīta Calendar iestatījumu, ievadiet skaitliskas mēnešu vērtības (saīsinātais datuma formāts).
Vaicājumu piemēri
| Izteiksme | Rezultāti |
|---|---|
| SELECT DateAdd("YYYY",1,[Sale_datums]) AS Expr1 FROM ProductSales; | Atgriež rezultātus, pieskaitot 1 gadu lauka "Pārdošanas datums" datumu vērtībām. |
| SELECT DateAdd("YYYY",-1,[Sale_datums]) AS Expr1 FROM ProductSales; | Atgriež rezultātus, lauka "Datums_pārdošana" datumu vērtībām atņemot 1 gadu. |
| SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; | Atgriež kolonnas "Jauns_datums" rezultātus, lauka "Pārdošanas datums" datumu vērtībām pieskaitot 10 dienas. |
| SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; | Atgriež rezultātus kolonnā "Jauns_datums", atņemot 1 nedēļu (7 dienas) no lauka "Pārdošanas datums" datumu vērtībām. |
VBA piemērs
Piezīme
Turpmākajos piemēros redzama šīs funkcijas izmantošana Visual Basic for Applications (VBA) modulī. Papildinformāciju par darbu ar VBA skatiet Access VBA atsaucē.
Šajā piemērā tiek izmantots datums kā ievade, un tiek izmantota funkcija DateAdd , lai parādītu atbilstošu datumu noteiktā mēnešu skaitā nākotnē.
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