Atgriež Variant (Date) vērtību ar datumu, kuram pievienots noteikts laika intervāls.
Sintakse
DateAdd (intervāls , skaitlis, datums )
Funkcijas DateAdd sintaksē ir šādi argumenti:
|
Arguments |
Apraksts |
|---|---|
|
intervāls |
Obligāts arguments. Virknes izteiksme, kas ir pievienojamā laika intervāls. |
|
skaitlis |
Obligāts arguments. Skaitliska izteiksme, kas ir pievienojaamo 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. Variant (Date) vai literālis, kas attēlo datumu, kuram pievienots intervāls. |
Iestatījumi
Intervālaarguments 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 pievienotu vai no datuma atņemtu noteiktu laika intervālu. Piemēram, varat izmantot DateAdd , lai aprēķinātu datumu, kas ir 30 dienas pēc šodienas, vai laika, kas ir 45 minūtes no šī datuma.
Lai datumam pievienotu dienas, varat izmantot Gada diena ("y"), Diena ("d") vai Nedēļas diena ("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 31-Jan-96, tas atgriež 29-Feb-96, jo 1996 ir leap gads.
Ja aprēķinātais datums ir pirms 100. gada (tas ir, tiek atņemts vairāk gadu nekā ir datuma), rodas kļūda.
Ja skaitlis nav gara vērtība, tas tiek noapaļots līdz tuvākajam veselajam skaitlim, pirms to novērtēt.
Piezīme.: DateAdd atgrieztās vērtības formātu nosaka pēc vadības panelis iestatījumiem, nevis pēc formāta, kas ir nodots argumentam datums.
Piezīme.: Datumam, ja rekvizīta Kalendārs iestatījums ir Gregora kalendārs, nodrošinātā datumam ir jābūt Gregora kalendāram. Ja kalendārs ir Hidžras, nodrošinātā datuma vērtībai ir jābūt Hidžras. Ja mēneša vērtības ir nosaukumi, nosaukumam ir jāatbilst pašreizējam rekvizīta Kalendārs iestatījumam. Lai samazinātu iespējamību, ka mēnešu nosaukumi konfliktē ar pašreizējo rekvizīta Kalendārs iestatījumu, ievadiet skaitliskās mēnešu vērtības (saīsinātais datuma formāts).
Vaicājumu piemēri
|
Izteiksme |
Rezultāti |
|---|---|
|
SELECT DateAdd("GGGG",1,[Pārdošanas_datums]) AS Expr1 FROM ProductSales; |
Atgriež rezultātus, lauka "Datumspārdošanas datums" datumu vērtībām pieskaitot 1 gadu. |
|
SELECT DateAdd("GGGG",-1,[Pārdošanas datums]) AS Expr1 FROM ProductSales; |
Atgriež rezultātus, atņemot 1 gadu lauka "Datumspārdošanas datums" datumu vērtībās. |
|
SELECT DateAdd("d",10,[Datumspārdošanas]) AS NewDate FROM ProductSales; |
Atgriež rezultātus kolonnā "NewDate", pievienojot 10 dienas lauka "DateofSale" datumu vērtībām. |
|
SELECT DateAdd("ww",-1,[Datumspārdošanas]) AS NewDate FROM ProductSales; |
Atgriež rezultātus kolonnā "Jauns_datums", atņemot 1 nedēļu (7 dienas) no lauka "Datumspārdošana" 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 rakstā Access VBA atsauce.
Šis piemērs izmanto datumu kā ievadi un izmanto funkciju DateAdd , lai parādītu atbilstošu datumu noteiktam mēnešu skaitam 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
