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. Virknes izteiksme, kas ir pievienojamais laika intervāls. |
|
skaitlis |
Obligāts. Skaitliska izteiksme, kas ir intervālu skaits, ko vēlaties pievienot. Tas var būt pozitīvs (lai iegūtu datumus nākotnē) vai negatīvs (lai iegūtu datumus pagātnē). |
|
datums |
Obligāts. Variant (Date) vai literālis, kas norāda intervālu, kuram jāpievieno intervāls. |
Padoms.: Programmā Access 2010 izteiksmju veidotājam ir IntelliSense, lai jūs varētu skatīt, kādi argumenti ir nepieciešami izteiksmei.
Iestatījumi
Intervāla arguments m 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 30 dienas no šodienas vai laika 45 minūtes no šī brīža.
Lai datumampievienotu dienas, varat izmantot gada dienu ("y"), dienu ("d") vai nedēļas dienu ("w").
Funkcija DateAdd atgriezīs nederīgu datumu. Šajā piemērā 31. janvārī 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 garais gads.
Ja aprēķinātais datums būs pirms gada 100 (tas ir, jūs atņemsiet vairāk gadu nekā ir datums), rodas kļūda.
Ja skaitlis nav gara vērtība, tas tiek noapaļots līdz tuvākajam veselajam skaitlim pirms vērtēšanas.
Piezīme.: DateAdd atgrieztās vērtības formātu nosaka vadības paneļa iestatījumi, nevis formāts, kas tiek nodots datuma argumentā.
Piezīme.: Datumam, ja kalendāra rekvizīta iestatījums ir Gregora Kalendārs , norādītais datums ir Gregora kalendārs. Ja kalendārā ir Hidžras kalendārs, norādītajam datumam jābūt Hidžras. Ja mēneša vērtības ir nosaukumi, nosaukumā jābūt konsekventām ar pašreizējā kalendāra rekvizīta iestatījumu. Lai samazinātu iespējamību mēnešu nosaukumiem, kas konfliktē ar pašreizējā kalendāra rekvizīta iestatījumu, ievadiet skaitlisko mēnešu vērtības (saīsinātais datuma formāts).
Vaicājumu piemēri
|
Izteiksme |
Rezultāti |
|
ATLASIET DateAdd ("YYYY", 1, [DateofSale]) kā Izteiksme1 no ProductSales; |
Atgriež rezultātus, pievienojot 1 gadu lauka "DateofSale" datuma vērtībām. |
|
ATLASIET DateAdd ("YYYY",-1, [DateofSale]) kā Izteiksme1 no ProductSales. |
Atgriež rezultātus, atņemot 1 gadu no lauka "DateofSale" datuma vērtībām. |
|
ATLASIET DateAdd ("d", 10, [DateofSale]) kā NewDate no ProductSales. |
Atgriež rezultātus kolonnā "NewDate", pievienojot 10 dienas lauka "DateofSale" datuma vērtībām. |
|
ATLASIET DateAdd ("ww",-1, [DateofSale]) kā NewDate no ProductSales. |
Atgriež rezultātus kolonnā "NewDate", atņemot 1 nedēļu (7 dienas) no lauka "DateofSale" datuma vērtībām. |
VBA piemērs
Piezīme.: Turpmākajos piemēros redzama šīs funkcijas izmantošana Visual Basic for Applications (VBA) modulī. Lai iegūtu papildinformāciju par darbu ar VBA, nolaižamajā sarakstā atlasiet Uzziņas materiāli izstrādātājiem blakus meklēšanas lodziņam un ievadiet šajā lodziņā vienu vai vairākus vārdus.
Šajā piemērā datums tiek rādīts kā ievade, un tiek izmantota funkcija DateAdd , lai rādītu atbilstošo 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
