Palauttaa variantin (päivämäärän), joka sisältää päivämäärän, johon on lisätty määritetty aikaväli.
Syntaksi
DateAdd(interval, number, date)
DateAdd Funktiolla on seuraavat argumentit:
| Argumentti | Kuvaus |
|---|---|
interval |
Pakollinen. Merkkijonolauseke, joka on lisättävä aikaväli. |
number |
Pakollinen. Numeerinen lauseke, joka on lisättävien välien määrä. Tulevien päivämäärien saaminen voi olla positiivista ja menneiden päivämäärien saaminen negatiivista. |
date |
Pakollinen. Variantti (päivämäärä) tai literaali, joka vastaa päivämäärää, johon väli lisätään. |
Asetukset
Argumentilla interval on seuraavat asetukset:
| Asetus | Kuvaus |
|---|---|
yyyy |
Vuosi |
q |
Neljännes |
m |
Kuukausi |
y |
Vuoden päivä |
d |
Päivä |
w |
Weekday |
ww |
Viikko |
h |
Tunti |
n |
Minuutti |
s |
Sekunti |
Huomautuksia
Funktion avulla DateAdd voit lisätä määritetyn aikavälin päivämäärään tai vähentää sen päivämäärästä. Voit esimerkiksi laskea päivämäärän, DateAdd joka on 30 päivän kuluttua tästä päivästä, tai kellonajan, joka on 45 minuutin kuluttua meneillään olevasta hetkestä.
Voit lisätä päiviä date, voit käyttää vuoden päivää ("y"), päivää ("d") tai viikonpäivää ("w").
DateAdd Funktio ei palauta virheellistä päivämäärää. Seuraavassa esimerkissä päivämäärään 31.1. lisätään yksi kuukausi:
DateAdd("m", 1, "31-Jan-95")
Tässä tapauksessa DateAdd palauttaa päivämäärän 28.2.1995, ei päivämäärää 31.2.1995. Jos date se on 31.1.1996, se palauttaa päivämäärän 29.2.1996, koska 1996 on karkausvuosi.
Jos laskettu päivämäärä edeltää vuotta 100 eli olet vähentänyt enemmän vuosia kuin luvussa dateon , tapahtuu virhe.
Jos number arvo ei ole pitkä, Access pyöristää sen lähimpään kokonaislukuun ennen lausekkeen laskentaa.
Huomautus
Palautusarvon DateAdd muoto määräytyy Ohjauspaneelin asetusten mukaan, ei argumentissa välitetyn date muotoilun mukaan.
Huomautus
Jos dateominaisuuden Calendar asetus on gregoriaaninen, päivämäärän täytyy antaa gregoriaaninen. Islamilaista kalenteria käytettäessä päivämäärä täytyy antaa islamilaisen kalenterin mukaisena. Jos kuukausiarvot ovat nimiä, nimen on vastattava nykyistä Calendar ominaisuusasetusta. Voit vähentää ristiriitojen mahdollisuutta syöttämällä numeeriset kuukausiarvot lyhyessä päivämäärämuodossa.
Esimerkkejä kyselyistä
| Lauseke | Tulokset |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Lisää yhden vuoden kentän päivämääräarvoihin DateofSale . |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Vähentää kentän päivämääräarvoista DateofSale 1 vuoden. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Lisää kentän päivämääräarvoihin DateofSale 10 päivää ja palauttaa tulokset sarakkeessa NewDate . |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Vähentää kentän päivämääräarvoista DateofSale 1 viikon tai 7 päivää ja palauttaa sarakkeen tulokset NewDate . |
VBA-esimerkki
Huomautus
Seuraavissa esimerkeissä kerrotaan, kuinka tätä funktiota käytetään Visual Basic for Applications (VBA) -moduulissa. Lisätietoja VBA-koodin käyttämisestä on Accessin VBA-viittauksessa.
Tässä esimerkissä päivämäärää käytetään syötteenä ja funktiota DateAdd käytetään näyttämään vastaava päivämäärä tietyn kuukausimäärän päässä tulevaisuudessa.
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