DateDiff függvény

Két dátum között megadott időtartományok számát tartalmazó Variant (hosszú) értéket ad eredményül.

További példák megtekintése

Szintaxis

DateDiff ( intervallum, dátum1, dátum2 [, hételsőnapja] [, évelsőhete] )

A DateDiff függvény argumentumai a következők:

Tipp : Az Access 2010-ben a Kifejezésszerkesztő IntelliSense technológiával rendelkezik, így láthatja a kifejezéshez szükséges argumentumokat. 

Argumentum

Leírás

intervallum

Kötelező. Karakterlánc-kifejezés, amely meghatározza a dátum1 és dátum2 közötti különbség kiszámításához használt időintervallumot.

dátum1, dátum2

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

hételsőnapja

Nem kötelező. A hét első napját megadó állandó. Ha nincs külön megadva, akkor a rendszer vasárnap használatát feltételezi.

évelsőhete

Nem kötelező. Az év első hetét megadó állandó. Ha nincs megadva, akkor a rendszer azt a hetet feltételezi, amelyben január 1-je szerepel.


Beállítások

Az intervallum argumentum beállításai a következők:

Beállítás

Leírás

yyyy

Év

q

Negyedév

m

Hónap

y

Év napja

d

Nap

w

Hétköznap

ww

Hét

h

Óra

n

Perc

s

Másodperc


Vissza a lap tetejére

A hételsőnapja argumentum beállításai a következők:

Állandó

É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


Állandó

Érték

Leírás

vbUseSystem

0

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

vbFirstJan1

1

Az első hét legyen az, amelyre január 1. esik (alapértelmezett).

vbFirstFourDays

2

Az első hét legyen az első olyan hét, amelynek legalább négy napja az új évben van.

vbFirstFullWeek

3

Az első hét legyen az év első teljes hete.


Megjegyzések

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

A dátum1 és a dátum2 közötti napok számának kiszámítása esetén az év napját („y”) vagy a napot („d”) használhatja egységként. Ha az intervallum értéke hétköznap („w”), akkor a DateDiff függvény a két dátum közötti hetek számát adja eredményül. Ha a dátum1 hétfőre esik, akkor a DateDiff függvény megszámolja a dátum2 dátumig előforduló hétfőket. Beleszámítja a dátum2 dátumot, de a dátum1 dátumot nem. Ha azonban az intervallum értéke a hét („ww”), akkor a DateDiff függvény a két dátum közötti naptári heteket adja eredményül. Megszámolja a dátum1 és a dátum2 közötti vasárnapok számát. A DateDiff beleszámítja a dátum2 dátumot, ha vasárnapra esik, de a dátum1 dátumot még akkor sem számítja bele, ha vasárnapra esik.

Ha a dátum1 időben későbbi, mint a dátum2, akkor a DateDiff függvény negatív számot ad eredményül.

A hételsőnapja argumentum azokat a számításokat befolyásolja, amelyek a „w” és a „ww” intervallumszimbólumokat használják.

Ha a dátum1 vagy a dátum2 egy dátumkonstans, akkor a megadott év a dátum állandó része lesz. Ha viszont a dátum1 vagy a dátum2 idézőjelben áll (" "), és elhagyja az évet, a programkódba az aktuális év kerül minden esetben, amikor a rendszer kiértékeli a dátum1 vagy a dátum2 kifejezés értékét. Így írhat olyan kódot is, amely különböző években is használható.

Ha december 31-ét és a következő év január 1-jét hasonlítja össze, akkor a DateDiff függvény az év beállítás („yyyy”) használata esetén 1-et ad eredményül, annak ellenére, hogy csak egy nap telt el.

Megjegyzés :  A dátum1 és a dátum2 megadásánál vegye figyelembe, hogy ha a Calendar tulajdonság Gergely-naptárra van állítva, akkor a megadott dátumnak is Gergely-naptár szerintinek kell lennie. Iszlám naptár használata esetén a megadott dátumnak az iszlám naptár szerintinek kell lennie.

Vissza a lap tetejére

Példák

A DateDiff függvény használata kifejezésben:    A DateDiff függvényt használhatja bárhol, ahol használható kifejezés. Tegyük fel például, hogy van egy űrlapja, amellyel a vevők rendeléseit rögzíti. A Rendelések táblában található egy KiszállításiHatáridő nevű mező, mely azt a dátumot tartalmazza, ameddig a vevőnek meg kell kapnia a rendelését. A DateDiff függvénnyel megjelenítheti az űrlapja egy szövegmezőjében a rendelés feladásához rendelkezésre álló napok számát.

Ha a rendelések kiszállítása tíz napot vesz igénybe, akkor a szövegmező Mező vagy kifejezés tulajdonságát a következő értékre állíthatja:

=DateDiff("d", Now(), [Rendelések].[KiszállításiHatáridő])-10

Amikor ezután megnyitja az űrlapot Űrlap nézetben, a szövegmező megjeleníti, hogy hány nap áll a rendelkezésére a rendelés feladására. Ha a vevőnek 10 napnál rövidebb idő alatt kell megkapnia a rendelését, akkor a szövegmezőben negatív érték jelenik meg, a szám pedig azt jelzi, hogy azonnali szállítás esetén hány nap késéssel fog megérkezni a rendelés.

A DateDiff függvény használata VBA-kódban:    

Megjegyzés : A következő példák egy Visual Basic for Applications (VBA) modulban mutatják be a függvény használatát. A VBA használatáról a Keresés elem mellett található legördülő listából a fejlesztői forrásokat választva, majd egy vagy több keresőszót megadva kaphat további tájékoztatást.

Ebben a példában a DateDiff függvény megjeleníti egy adott nap és a mai nap közötti napok számát.

Dim TheDate As Date    ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date")
Msg = "Days from today: " & DateDiff("d", Now, TheDate)
MsgBox Msg
Ismeretek bővítése
Oktatóanyagok megismerése
Új szolgáltatások listájának lekérése
Részvétel az Office Insider programban

Hasznos volt az információ?

Köszönjük a visszajelzését!

Köszönjük visszajelzését. Jobbnak látjuk, ha az Office egyik támogatási szakemberéhez irányítjuk.

×