Funktsioon DateDiff

Tagastatakse andmed, mille tüüp on Variant (pikk) ja mis määravad kahe konkreetse kuupäeva vahelised ajavahemikud.

Vt näiteid

Süntaks

DateDiff ( interval, date1, date2 [, firstdayofweek] [, firstweekofyear] )

Funktsiooni DateDiff süntaksil on järgmised argumendid.

Näpunäide. :  Rakenduses Access 2010 on avaldisekoosturil IntelliSense, mis näitab, milliseid argumente avaldises kasutada tuleb. 

Argument

Kirjeldus

interval

Nõutav. Stringavaldis, millega määratakse ajavahemik kuupäeva 1 (date1) ja kuupäeva 2 (date2) vahelise erinevuse arvutamiseks.

date1, date2

Nõutav. Andmetüüp Variant (kuupäev). Kaks kuupäeva, mida soovite arvutamisel kasutada.

firstdayofweek

Valikuline. Nädala esimest päeva määrav konstant. Kui seda pole määratud, siis eeldatakse, et see on pühapäev.

firstweekofyear

Valikuline. Aasta esimest nädalat määrav konstant. Kui seda pole määratud, siis eeldatakse, et see on 1. jaanuari nädal.


Sätted

Argumendil interval on järgmised sätted.

Säte

Kirjeldus

yyyy

Aasta

q

Kvartal

m

Kuu

y

Kuupäev

d

Päev

w

Nädalapäev

ww

Nädal

h

Tund

n

Minut

s

Sekund


Lehe algusse

Argumendil firstdayofweek on järgmised sätted.

Konstant

Väärtus

Kirjeldus

vbUseSystem

0

Kasutatakse NLS API sätet.

vbSunday

1

Pühapäev (vaikeväärtus)

vbMonday

2

Esmaspäev

vbTuesday

3

Teisipäev

vbWednesday

4

Kolmapäev

vbThursday

5

Neljapäev

vbFriday

6

Reede

vbSaturday

7

Laupäev


Konstant

Väärtus

Kirjeldus

vbUseSystem

0

Kasutatakse NLS API sätet.

vbFirstJan1

1

Alustatakse 1. jaanuari nädalast (vaikeväärtus).

vbFirstFourDays

2

Alustatakse esimesest nädalast, millel on uues aastas vähemalt neli päeva.

vbFirstFullWeek

3

Alustatakse aasta esimesest täisnädalast.


Märkused

Saate funktsiooni DateDiff abil kindlaks teha, mitu määratud ajavahemikku kahe kuupäeva vahele jääb. Näiteks saate funktsiooni DateDiff abil arvutada kahe kuupäeva vahele jäävate päevade arvu või tänasest aasta lõpuni jäävate päevade arvu.

Kahe kuupäeva (date1 ja date2) vahele jäävate päevade arvutamiseks saate kasutada kas kuupäeva („y”) või päeva („d”). Kui argumendi interval väärtuseks on nädalapäev („w”), tagastab DateDiff kahe kuupäeva vahelise nädalate arvu. Kui kuupäev 1 (date1) langeb esmaspäevale, loendab DateDiff kuupäevani 2 (date2) jäävate esmaspäevade arvu. Funktsioon loendab ka kuupäeva 2 (date2), kuid mitte kuupäeva 1 (date1). Kui argumendi interval väärtuseks on nädal („ww”), tagastab funktsioon DateDiff kahe kuupäeva vahele jäävate kalendrinädalate arvu. Funktsioon loendab kahe kuupäeva (date1 ja date2) vahele jäävate pühapäevade arvu. Funktsioon DateDiff arvab sisse kuupäeva 2 (date2), kui see langeb pühapäevale, aga mitte kuupäeva 1 (date1), isegi kui see langeb pühapäevale.

Kui kuupäev 1 (date1) on pärast kuupäeva 2 (date2), siis tagastab funktsioon DateDiff negatiivse arvu.

Argument firstdayofweek mõjutab arvutusi, kus kasutatakse vahemikusümboleid „w” ja „ww”.

Kui date1 või date2 on kuupäevaliteraal, muutub määratud aasta selle kuupäeva püsivaks osaks. Kui argumendi date1 või date2 väärtus on kahekordsetes jutumärkides (" ") ja aasta on ära jäetud, sisestatakse praegune aasta igal kuupäeva 1 (date1) või kuupäeva 2 (date2) avaldise hindamisel koodi. Nii on võimalik kirjutada koodi, mida saab kasutada eri aastatel.

31. detsembri võrdlemisel vahetult järgneva aasta 1. jaanuariga tagastab DateDiff aasta väärtusena („yyyy”) arvu 1, kuigi vahemik hõlmab ainult ühte päeva.

Märkus. :  Kui atribuudi Kalender sätteks on valitud Gregoriuse, peab argumendi date1 ja date2 kuupäeva määrama samuti Gregoriuse kalendri järgi. Islami kalendri korral tuleb kasutada islami ajaarvestusele vastavat kuupäeva.

Lehe algusse

Näited

Funktsiooni DateDiff kasutamine avaldises.     Funktsiooni DateDiff saate kasutada alati siis, kui kasutate avaldisi. Oletame näiteks, et teil on vorm, mida kasutate klientide tellimuste täitmiseks. Tabelis „Tellimused“ on väli „Tarnekuupäev“, mis sisaldab tähtaega, kui klient peab olema tellimuse kätte saanud. Saate tellimuse tarnekuupäevani jäänud päevade kuvamiseks kasutada selles vormis oleval tekstiväljal funktsiooni DateDiff.

Eeldades, et mis tahes tellimuse tarnimiseks läheb aega kümme päeva, saate määrata tekstivälja atribuudi Juhtelemendi allikas järgmiselt:

=DateDiff(“d”, Now(), [Tellimused].[Tarnekuupäev])-10

Kui avate vormi vormivaates, kuvatakse tekstiväljal tellimuse tarnekuupäevani jäänud päevade arv. Kui kättetoimetamiseni on jäänud vähem kui 10 päeva, on tekstiväljal negatiivne arv, mis näitab seda, mitu päeva tellimus hilineb, kui see kohe välja saata.

Funktsiooni DateDiff kasutamine VBA-koodis    

Märkus. : Järgmised näited kujutavad selle funktsiooni kasutamist rakenduse Visual Basic for Applications (VBA) moodulis. Lisateabe saamiseks VBA-ga töötamise kohta valige välja Otsing kõrval kuvatavast ripploendist väärtus Tootearendusmaterjal ja sisestage otsinguväljale üks või mitu sõna.

Selles näites kuvatakse funktsiooni DateDiff abil konkreetse kuupäeva ja tänase päeva vahele jäävate päevade arv.

Dim TheDate As Date    ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date")
Msg = "Days from today: " & DateDiff("d", Now, TheDate)
MsgBox Msg
Täiendage oma oskusi
Tutvuge koolitusmaterjalidega
Kasutage uusi funktsioone enne teisi
Liituge Office Insideri programmiga

Kas sellest teabest oli abi?

Täname tagasiside eest!

Täname tagasiside eest! Tundub, et võiksime teid kokku viia ühega meie Office'i tugiagentidest, kes aitab teil probleemi lahendada.

×