Access függvényei
DatePart függvény

DatePart függvény

Egy Variant (Integer) típussal tér vissza, amely a megadott dátum egy részét tartalmazza.

A DatePart függvénnyel megvizsgálhatunk egy dátumot, és egy megadott idő-mértékegységet kérdezhetünk le. A DatePart segítségével például meghatározhatjuk a hét aktuális napját vagy a folyó órát.

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átum egy dátum szövegkonstans, akkor a megadott év a dátum állandó részévé válik. Ha viszont a dátumot kettős idézőjelek (" ") közé foglaljuk, az évet pedig elhagyjuk, akkor a dátum 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ó.

Megjegyzés:  A dátumban megadott dátumnak Gergely-naptár szerintinek kell lennie, ha a Calendar tulajdonság beállítása Gergely. Ha hidzsri naptárat használunk, a megadott dátumnak is hidzsri formátumúnak kell lennie.

A kapott dátumrész az aktuális arab naptár időegységeiben értendő. Ha például az aktuális naptár hidzsri, és a dátum év részét kérdezzük le, akkor a kapott év érték hidzsri évnek értelmezendő.

Szintaxis

DatePart(időtartam, dátum [, hét első napja [, év első hete]])

A DatePart 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 visszaadandó időtartamot határozza meg.

dátum

Kötelező. A kiértékelendő Variant (Date) érték.

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

Az év első hete 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.

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