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 ( väli, luku, päivämäärä )
DateAdd-funktion syntaksilla on seuraavat argumentit:
|
Argumentti |
Kuvaus |
|---|---|
|
aikaväli |
Pakollinen. Merkkijonolauseke, joka on lisättävä aikaväli. |
|
luku |
Pakollinen. Numeerinen lauseke, joka on lisättävien välien määrä. Määrä voi olla positiivinen (tulevat päivämäärät) tai negatiivinen (menneet päivämäärät). |
|
päivämäärä |
Pakollinen. Variantti (päivämäärä) tai literaali, joka vastaa päivämäärää, johon väli lisätään. |
Asetukset
Aikaväli argumentti-argumentin asetukset ovat seuraavat:
|
Asetus |
Kuvaus |
|---|---|
|
yyyy |
Vuosi |
|
q |
Vuosineljännes |
|
m |
Kuukausi |
|
y |
Vuoden päivä |
|
d |
Päivä |
|
w |
Viikonpäivä |
|
ww |
Viikko |
|
h |
Tunti |
|
n |
Minuutti |
|
s |
Sekunti |
Huomautuksia
DateAdd-funktiolla voit lisätä määritetyn aikavälin päivämäärään tai vähentää sen päivämäärästä. Voit laskea DateAdd-funktiolla esimerkiksi päivämäärän, joka on 30 päivän kuluttua tästä päivästä, tai kellonajan, joka on 45 minuutin kuluttua meneillään olevasta hetkestä.
Jos haluat lisätä päiviä päivämäärä-argumentin arvoon, käytä vuoden päivä -asetusta (y), päivän asetusta (d) tai viikonpäivän asetusta (w).
DateAdd-funktio ei palauta virheellistä päivämäärää. Seuraavassa esimerkissä lisätään kuukausi tammikuun 31. päivään:
DateAdd("m", 1, "31-Jan-95")
Tässä tapauksessa DateAdd-funktio palauttaa päivämäärän 28.2.1995, ei päivämäärää 31.2.1995. Jos päivämäärä on 31.1.1996, funktio palauttaa päivämäärän 29.2.1996, koska 1996 on karkausvuosi.
Jos laskettu päivämäärä edeltää vuotta 100 (eli jos olet vähentänyt päivämäärä-argumenttia enemmän vuosia), tapahtuu virhe.
Jos luku ei ole Long-arvo, se pyöristetään lähimpään kokonaislukuun ennen laskutoimitusta.
Huomautus: Päivämäärä-argumenttiin välittyvä muoto ei määritä DateAdd-funktion palautusarvon muotoa, vaan sen määrittävät Ohjauspaneelin asetukset.
Huomautus: Jos kalenterin ominaisuusasetus on Gregoriaaninen, päivämäärä-argumenttien päivämäärä täytyy antaa gregoriaanisen kalenterin mukaisena. Islamilaista kalenteria käytettäessä päivämäärä täytyy antaa islamilaisen kalenterin mukaisena. Jos kuukausiarvot ovat nimiä, nimen täytyy olla yhdenmukainen käytössä olevan kalenterin ominaisuusasetuksen kanssa. Voit välttyä kuukausien nimien ja käytössä olevan kalenterin ominaisuusasetuksen ristiriitatilanteilta käyttämällä numeerisia kuukausiarvoja (lyhyttä päivämäärämuotoa).
Esimerkkejä kyselystä
|
Lauseke |
Tulokset |
|---|---|
|
SELECT DateAdd("YYYY",1;[DateofSale]) AS Expr1 FROM ProductSales; |
Palauttaa tulokset lisäämällä vuoden päivämääräarvoihin kentän "DateofSale". |
|
SELECT DateAdd("YYYY",-1;[DateofSale]) AS Expr1 FROM ProductSales; |
Palauttaa tulokset vähentämällä vuoden päivämääräarvoista kentän "DateofSale". |
|
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Palauttaa tulokset NewDate-sarakkeessa lisäämällä 10 päivää DateofSale-kentän päivämääräarvoihin. |
|
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Palauttaa tulokset NewDate-sarakkeessa vähentämällä 1 viikon (7 päivää) päivämääräarvoista kentän "DateofSale". |
VBA-esimerkki
Huomautus: Seuraavissa esimerkeissä kerrotaan, kuinka tätä funktiota käytetään Visual Basic for Applications (VBA) -moduulissa. Lisätietoja VBA:n käsittelemisestä on artikkelissa Accessin VBA-viittaus.
Tässä esimerkissä päivämäärää käytetään syötteenä ja DateAdd-funktiota käytetään sellaisen päivämäärän näyttämiseen, joka on 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
