Atgriež Variant (Date), kas satur datumu ar pievienotu noteiktu laika intervālu.
Sintakse
DateAdd(interval, number, date)
Funkcijai DateAdd ir šādi argumenti:
| Arguments | Apraksts |
|---|---|
interval |
Obligāts arguments. Virknes izteiksme, kas ir pievienojamais laika intervāls. |
number |
Obligāts arguments. Skaitliska izteiksme, kas ir pievienojamo intervālu skaits. Var būt pozitīvi iegūt datumus nākotnē vai negatīvi iegūt datumus pagātnē. |
date |
Obligāts arguments. Variants (datums) vai literālis, kas apzīmē datumu, līdz kuram pievienots intervāls. |
Iestatījumi
Argumentam interval ir šādi iestatījumi:
| Iestatījums | Apraksts |
|---|---|
yyyy |
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
Šo funkciju var izmantot, 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, vai laiku, kas seko 45 minūtēm.
Lai pievienotu dienas date, 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.februāris-95, nevis 31-Feb-95. Ja date ir 31-Jan-96, tas atgriež 29-Feb-96, jo 1996 ir garais gads.
Ja aprēķinātais datums ir pirms gada 100, kas nozīmē to, ka tiek atņemts vairāk gadu nekā ir , daterodas kļūda.
Ja number šī vērtība nav gara, Access to noapaļo līdz tuvākajam veselajam skaitlim, pirms novērtē izteiksmi.
Piezīme
Atgrieztās vērtības DateAdd formātu nosaka vadības paneļa iestatījumi, nevis argumentā date nodotais formāts.
Piezīme
Ja daterekvizīta iestatījums Calendar ir Gregora kalendāra, 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ējā Calendar rekvizīta iestatījumam. Lai samazinātu konfliktu iespējamību, ievadiet skaitlisku mēnešu vērtības īsajā datuma formātā.
Vaicājumu piemēri
| Izteiksme | Rezultāti |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Datumu vērtībām laukā pieskaita DateofSale 1 gadu. |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Atņem 1 gadu no datumu vērtībām DateofSale laukā. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Pieskaita 10 dienas datumu vērtībām DateofSale laukā un atgriež rezultātus NewDate kolonnā. |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Atņem 1 nedēļu vai 7 dienas no datumu vērtībām DateofSale laukā un atgriež rezultātus NewDate kolonnā. |
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ā datums tiek izmantots kā ievade, un funkcija izmanto DateAdd atbilstošo datumu, kas ir noteikts mēnešu skaits 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