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 įtraukti. |
|
skaičius |
Būtinas. Skaitinis reiškinys, kuris yra intervalų, kuriuos norite įtraukti, skaičius. 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ė, nurodanti datą, prie kurios intervalas pridedamas. |
Parametrai
Intervalo argumentas parametrai:
|
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
Funkciją DateAdd galite naudoti norėdami pridėti arba atimti nurodytą laiko intervalą iš datos. Pavyzdžiui, galite naudoti DateAdd norėdami apskaičiuoti datą 30 dienų nuo šiandien arba laiką 45 minutes nuo dabar.
Norėdami įtraukti dienų į datą, galite naudoti metų dieną ("y"), dieną ("d") arba darbo dieną ("w").
Funkcija DateAdd nepateiks 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-Vas-95, o ne 95-vas-31. Jei data yra 31-Sau-96, ji pateikia 29-Vas-96, nes 1996 yra keliamieji metai.
Jei apskaičiuota data būtų prieš 100 metų (t. y. atimate daugiau metų nei yra datose), įvyksta klaida.
Jei skaičius nėra ilgoji reikšmė, prieš vertinant jis suapvalinamas iki artimiausio sveikojo skaičiaus.
Pastaba: DateAdd grąžinamos reikšmės formatas nustatomas pagal valdymo skydo parametrus, o ne formatą, perduotą datos argumente.
Pastaba: Jei datos ypatybės Kalendorius parametras yra Grigaliaus, pateikta data turi būti Grigaliaus. Jei kalendorius yra Hidžros kalendorius, pateikiama data turi būti Hidžri. Jei mėnesio reikšmės yra pavadinimai, pavadinimas turi atitikti dabartinį ypatybės Kalendorius parametrą. Norėdami sumažinti mėnesio pavadinimų nesuderinamumo su dabartiniu ypatybės Kalendorius parametru galimybę, įveskite skaitines mėnesio reikšmes (trumpasis datos formatas).
Užklausų pavyzdžiai
|
Reiškinys |
Rezultatai |
|---|---|
|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Grąžina rezultatus pridedant 1 metus prie lauko "DateofSale" datos reikšmių. |
|
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Grąžina rezultatus atimdami 1 metus prie lauko "DateofSale" datos reikšmių. |
|
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Grąžina stulpelio "NewDate" rezultatus pridedant 10 dienų prie datos reikšmių lauke "DateofSale". |
|
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Grąžina stulpelio "NewDate" rezultatus atimdami 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 žr. "Access" VBA nuoroda.
Šiame pavyzdyje data naudojama kaip įvestis ir naudojama funkcija DateAdd , kad būtų rodoma atitinkama data ir nurodytas mėnesių skaičius ateityje.
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
