DateAdd-funktio

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

vä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.


Vihje:  Access 2010:ssä Expression Builderillä on IntelliSense-toiminto, joten voit nähdä lausekkeen vaatimat argumentit. 

Asetukset

Aikaväli argumentti-argumentin asetukset ovat seuraavat:

Asetus

Kuvaus

yyyy

Vuosi

q

Vuosineljännes

k

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 ei-kelvollista 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-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).

Esimerkki

Huomautus: Seuraavissa esimerkeissä kerrotaan, kuinka tätä funktiota käytetään Visual Basic for Applications (VBA) -moduulissa. Jos haluat lisätietoja VBA:n käytöstä, valitse Sovelluskehittäjän opasHaku-kentän viereisestä luettelosta ja anna yksi tai useampi hakuehto hakukenttään.

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
Kehitä taitojasi
Tutustu koulutusmateriaaliin
Saat uudet ominaisuudet ensimmäisten joukossa
Liity Office Insider -käyttäjiin

Oliko näistä tiedoista hyötyä?

Kiitos palautteesta!

Kiitos palautteestasi! Näyttää siltä, että Office-tukiedustajamme avusta voi olla sinulle hyötyä.

×