Access függvényei
 DateDiff függvény

DateDiff függvény

Egy Variant (Long) értékkel tér vissza, amely a két megadott időpont közötti időtartamok számát tartalmazza.

A DateDiff függvény segítségével megállapíthatjuk, hogy két dátum között hány telik el a megadott időtartamból. A DateDiff függvénnyel például kiszámíthatjuk a két dátum között eltelő napok, vagy a mai nap és az év vége közé eső hetek számát.

Ha a dátum1 és dátum2 között eltelő napok számát szeretnénk megkapni, akkor az év napjai ("y") és a nap ("d") beállítást egyaránt használhatjuk. Ha az időtartam értéke hét napjai ("w"), akkor a DateDiff a két dátum közötti hetek számát adja meg. Ha a dátum1 hétfőre esik, a DateDiff a dátum2-ig eltelő hétfőket számlálja meg. Számláláskor a dátum2-t figyelembe veszi, de dátum1-et nem. Ha az időtartam értéke hét ("ww"), akkor a DateDiff függvény a két dátum között eltelő naptári hetek számát adja meg. A függvény a dátum1 és a dátum2 között eltelő vasárnapokat számlálja meg. A DateDiff a dátum2-t figyelembe veszi, ha az vasárnapra esik, ám a dátum1-et még akkor sem, ha az történetesen vasárnapi nap.

Ha a dátum1 egy későbbi időpontra utal, mint a dátum2, a DateDiff függvény negatív számmal tér vissza.

A hét első napja argumentum azoknál a számításoknál jut szerephez, amelyeknél az időtartamot a "w" vagy a "ww" szimbólummal adjuk meg.

Ha a dátum1 vagy a dátum2 egy dátum szövegkonstans, a megadott év az adott dátum állandó részévé válik. Ha viszont a dátum1-et vagy a dátum2-t kettős idézőjelek (" ") közé foglaljuk, az évet pedig elhagyjuk, akkor a dátum1 és a dátum2 kifejezés kiértékelésekor a rendszer mindig az aktuális évet illeszti be a kódba. Ezzel a módszerrel olyan programkódot is lehet írni, amely eltérő években is használható.

Ha december 31-ét a következő év január 1-jével hasonlítjuk össze, a DateDiff az év ("yyyy") argumentummal meghívva minden esetben 1-et ad, noha a két időpont között csak egyetlen nap telik el.

Megjegyzés:   A dátum1 és dátum2 argumentumokban megadott dátumoknak Gergely-naptár szerintieknek kell lenniük, ha a Calendar tulajdonság beállítása Gergely. Ha hidzsri naptárat használunk, a megadott dátumoknak is hidzsri formátumúaknak kell lenniük.

Szintaxis

DateDiff(időtartam, dátum1, dátum2 [, hét első napja [, év első hete]])

A DateDiff függvény szintaxisában a következő elnevezett argumentumokat különböztetjük meg:

Rész

Leírás

időtartam

Kötelező. Karakterlánc-kifejezés, amely a dátum1 és a dátum2 közötti időkülönbség számításakor használni kívánt időegységet adja meg.

dátum1, dátum2

Kötelező Variant (Date). A számításban használni kívánt két dátum.

hét első napja

Elhagyható. Egy konstans, amely a hét első napját adja meg. Ha elhagyjuk, az alapértelmezett érték a vasárnap.

év első hete

Elhagyható. Konstans, amely az év első hetét adja meg. Ha elhagyjuk, akkor az lesz az első hét, amelyre január 1-je esik.

 

Beállítások

Az időtartam argumentum lehetséges értékei a következők:

Beállítás

Leírás

yyyy

Év

q

Negyed

m

Hónap

y

Év napjai

d

Nap

w

Hét napjai

ww

Hét

h

Óra

n

Perc

s

Másodperc

 

A hét első napja argumentum lehetséges értékei a következők:

Konstans

Érték

Leírás

vbUseSystem

0

Az NLS API beállítás használata.

vbSunday

1

Vasárnap (alapértelmezett)

vbMonday

2

Hétfő

vbTuesday

3

Kedd

vbWednesday

4

Szerda

vbThursday

5

Csütörtök

vbFriday

6

Péntek

vbSaturday

7

Szombat

 

Konstans

Érték

Leírás

vbUseSystem

0

Az NLS API beállítás használata.

vbFirstJan1

1

Kezdés azzal a héttel, amelyre január 1-je esik (alapértelmezett).

vbFirstFourDays

2

Kezdés az első olyan héttel, amelynek legalább négy napja az új évbe esik.

vbFirstFullWeek

3

Kezdés az első teljes egészében az új évbe eső héttel.

Következő leckéhez klikkelje!

Bezárás