Applies ToMicrosoft 365-höz készült Access Access 2024 Access 2021 Access 2019 Access 2016

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

Szintaxis

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

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

argumentumok

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

Megadása 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

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 legyen az első hét, amelybe 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.

DateDiff-lekérdezési példák

Expression

Eredmények

SELECT DateDiff("yyyy",#01/01/2010#,[DateofSale]) AS Expr1 FROM ProductSales;

A Date2 és a Date1 közötti különbséget adja vissza (a Date1 értéket a legrégebbinek, a Date2-et pedig a legújabbnak) a "Years" (Év) értéket. Eredmény: A "DateofSale" mező értékei és a "2010.01.01." dátum "Years" számának különbsége.

SELECT DateDiff("q",[DateofSale],Date()) AS DaysSinceSale FROM ProductSales;

A rendszerdátum és a "DateofSale" közötti különbséget adja vissza a "Negyedévek" számaként (a calender éve alapján), és a "DaysSinceSale" oszlopban jelenik meg. A a rendszerdátum és a "DateofSale" közötti különbséget "Hónapok" számként adja vissza, és a "DaysSinceSale" oszlopban jelenik meg.

SELECT DateDiff("y",[DateofSale],Date()) AS DaysSinceSale FROM ProductSales;

A rendszerdátum és a "DateofSale" közötti különbséget "Days" számként adja vissza, és a "DaysSinceSale" oszlopban jelenik meg.

SELECT DateDiff("d",[DateofSale],Date()) AS DaysSinceSale FROM ProductSales;

A rendszerdátum és a "DateofSale" közötti különbséget "Days" számként adja vissza, és a "DaysSinceSale" oszlopban jelenik meg.

SELECT DateDiff("w",[DateofSale],Date()) AS DaysSinceSale FROM ProductSales;

A rendszerdátum és a "DateofSale" közötti különbséget adja vissza a "Hétköznapok" számmal, és a "DaysSinceSale" oszlopban jelenik meg. Ha a "DateofSale" hétfőre esik, a DateDiff megszámolja a hétfők számát a rendszer dátumáig. Megszámolja a rendszerdátumot, de a "DateofSale" értékét nem.

SELECT DateDiff("ww",[DateofSale],Date()) AS DaysSinceSale FROM ProductSales;

A rendszerdátum és a "DateofSale" közötti különbséget adja vissza a "Calender Weeks" számként, és a "DaysSinceSale" oszlopban jelenik meg. Megszámolja a "DateofSale" és a "rendszerdátum" közötti vasárnapok számát. Megszámolja a rendszerdátumot, ha vasárnapra esik; de nem számít "DateofSale", még akkor sem, ha nem esik egy vasárnap.

SELECT DateDiff("h",[DateTime],Date()) AS DaysSinceSale FROM ProductSales;

A rendszerdátum és a "DateTime" közötti különbséget adja vissza "Óra" számként, és a "DaysSinceSale" oszlopban jelenik meg.

SELECT DateDiff("n",[DateTime],Date()) AS DaysSinceSale FROM ProductSales;

A rendszerdátum és a "DateTime" közötti különbséget a "Percek" számaként adja vissza, és a "DaysSinceSale" oszlopban jelenik meg.

SELECT DateDiff("s";[DateTime];Date()) AS DaysSinceSale FROM ProductSales;

A rendszerdátum és a "DateTime" közötti különbséget adja vissza másodpercben, és a "DaysSinceSale" oszlopban jelenik meg.

Példakifejezés

A DateDiff függvény használata kifejezésben     A DateDiff függvényt bárhol használhatja, ahol kifejezéseket használhat. 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.

VBA-példa

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

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 MsgTheDate = InputBox("Enter a date")Msg = "Days from today: " & DateDiff("d", Now, TheDate)MsgBox Msg

Lásd még

A megfelelő dátumfüggvény kiválasztása

További segítségre van szüksége?

További lehetőségeket szeretne?

Fedezze fel az előfizetés előnyeit, böngésszen az oktatóanyagok között, ismerje meg, hogyan teheti biztonságossá eszközét, és így tovább.

A közösségek segítségével kérdéseket tehet fel és válaszolhat meg, visszajelzést adhat, és részletes ismeretekkel rendelkező szakértőktől hallhat.