Pateikia variantą (datą), kuriame yra data, prie kurios buvo pridėtas nurodytas laiko intervalas.
Sintaksė
DateAdd(intervalas, skaičius, data)
Funkcijos DateAdd sintaksė turi tokius argumentus:
| Argumentas | Aprašas |
|---|---|
| intervalas | Būtinas. Eilutės reiškinys, kuris yra laiko intervalas, kurį norite pridėti. |
| skaičius | Būtinas. Skaitinis reiškinys, kuris yra intervalų skaičius, kurį norite pridėti. Gali būti teigiamas (kad būtų gautos datos ateityje) arba neigiamas (kad būtų gautos datos praeityje). |
| data | Būtinas. Variantas (data) arba raidė, žyminti datą, prie kurios intervalas buvo pridėtas. |
Parametrai
Intervaloargumento parametrai yra tokie:
| Parametras | Aprašas |
|---|---|
| yyyy | Metai |
| q | Ketvirtis |
| m | Mėnuo |
| y | Metų diena |
| d | Diena |
| w | Weekday |
| ww | Savaitė |
| h | Valanda |
| n | Minutė |
| s | Sekundė |
Pastabos
Naudodami funkciją DateAdd galite pridėti arba atimti nurodytą laiko intervalą iš datos. Pavyzdžiui, galite naudoti "DateAdd", kad apskaičiuotumėte datą po 30 dienų nuo šiandien arba laiką po 45 minučių.
Norėdami pridėti dienas prie datos, galite naudoti Year Day ("y"), Day ("d") arba Weekday ("w").
Funkcija DateAdd negrąžins neleistinos datos. Toliau pateiktame pavyzdyje prie sausio 31 d. pridedamas vienas mėnuo:
DateAdd("m", 1, "31-Jan-95")
Šiuo atveju DateAdd grąžina 28-Feb-95, o ne 31-Feb-95. Jei data yra 96-Sau-31, grąžinama 96-Vas-29, nes 1996 metai yra keliamieji.
Jei apskaičiuota data yra prieš 100 metus (t. y. atimsite daugiau metų nei yra iš datos), įvyks klaida.
Jei skaičius nėra ilgoji reikšmė, prieš vertinant jis suapvalinamas iki artimiausio sveikojo skaičiaus.
Pastaba
DateAdd pateikiamos reikšmės formatą nustato valdymo skydo parametrai, o ne formatas, perduodamas datos argumente.
Pastaba
Datai, jei ypatybės Calendar parametras yra Grigaliaus, pateikta data turi būti Grigaliaus. Jei kalendorius yra Hidžros, pateikta data turi būti Hidžros kalendorius. Jei mėnesio reikšmės yra pavadinimai, pavadinimas turi atitikti dabartinį ypatybės Calendar parametrą. Norėdami sumažinti mėnesių pavadinimų nesuderinamumą su dabartiniu ypatybės Calendar nustatymu, įveskite skaitines mėnesių reikšmes (trumposios datos formatas).
Užklausų pavyzdžiai
| Išraiška | Rezultatai |
|---|---|
| SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; | Pateikia rezultatą prie lauko "DateofSale" datos reikšmių pridedant 1 metus. |
| SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; | Pateikia rezultatą iš lauko "DateofSale" datos reikšmių atėmus 1 metus. |
| SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; | Pateikia rezultatus stulpelyje "Nauja_data" pridedant 10 dienų prie lauko "DateofSale" datos reikšmių. |
| SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; | Grąžina rezultatus stulpelyje "Nauja_data" atėmus 1 savaitę (7 dienas) iš lauko "DateofSale" datos reikšmių. |
VBA pavyzdys
Pastaba
Pateiktuose pavyzdžiuose parodyta, kaip naudoti šią funkciją „Visual Basic for Applications“ (VBA) modulyje. Daugiau informacijos apie darbą su VBA rasite "Access" VBA nuorodoje.
Šiame pavyzdyje data naudojama kaip įvestis ir naudojama funkcija "DateAdd " atitinkamai datai rodyti nurodytą mėnesių skaičių į priekį.
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