A dátum adott részét tartalmazó Variant (egész) értéket ad eredményül.
| Figyelmeztetés Probléma merült fel a függvény használatával kapcsolatban. Egyes naptári években az utolsó hétfő 53. hétként adható vissza, amikor annak 1. hétnek kellene lennie. További információt és egy kerülő megoldást a Format és a DatePart függvény hibás hétszámot adhat vissza az év utolsó hétfőjén. |
|---|
Szintaxis
DatePart(intervallum; dátum [;hét_elsőnapja] [; évkezdő_hét])
A DatePart függvény szintaxisa az alábbi argumentumokat foglalja magában:
| Argumentum | Leírás: |
|---|---|
| intervallum | Kötelező megadni. Az eredményül kapott időtartományt tartalmazó karakterlánc. |
| dátum | Kötelező megadni. A kiértékelni kívántdátumérték. |
| hét_első_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 időköz 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ét_első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 |
Az év_elsőhete 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 |
| 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 DatePart függvénnyel kiértékelhet egy dátumot, és visszaadhat egy adott időintervallumot. A DatePart függvénnyel például kiszámíthatja a hét napjait vagy az aktuális órát.
A hétkezdő_nap argumentum a "w" és a "ww" intervallumszimbólumokat használó számításokat befolyásolja.
Ha a dátum dátumkonstans, akkor a megadott év a dátum állandó része lesz. Ha azonban a dátumot dupla idézőjelek (" ") közé teszi, és elhagyja az évet, a programkódba az aktuális év kerül be a dátumkifejezés minden egyes kiértékelésekor. Így írhat olyan kódot is, amely különböző években is használható.
Megjegyzés
Ha a dátum beállítása a Calendar tulajdonság Gergely-naptár szerinti értékre van állítva, a megadott dátumnak 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.
Az eredményül visszaadott dátumrész az aktuális arab naptár időintervallum-egységeiben van megadva. Ha például az aktuális naptár az iszlám naptár, és az eredményül adott dátumrész év, akkor az év iszlám év.
Példák lekérdezésekre
| Expression (Kifejezés) | Eredmény: |
|---|---|
| SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales; | Az "Értékesítésdátuma" mező dátumértékeinek "Év" értékét adja eredményül. |
| SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales; | Az "Értékesítésdátum" mező dátumértékeinek negyedévét adja vissza (a naptárév alapján). |
| SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales; | Az "Értékesítés_dátuma" mező dátumértékeinek "Nap" értékét adja vissza (1 – 365). |
| SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales; | Az "Értékesítésdátum" mező dátumértékeinek "Nap" értékét adja eredményül. |
| SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales; | Az "Értékesítésdátuma" mező dátumértékeinek "Hétköznap" értékét adja vissza (1 és 7 között, ahol az 1 a vasárnapot jelöli). |
| SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales; | Az "Értékesítés_dátuma" mező dátumértékeinek "Hét száma" értékét adja vissza (1 és 52 között). |
| SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales; | A "Dátum/idő" mező dátumértékeinek "óra" értékét adja eredményül. |
| SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales; | A "Dátum/idő" mező dátumértékeinek "perc" értékét adja eredményül. |
| SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales; | A "Dátum/idő" mező dátumértékeinek "másodpercit" adja eredményül. |
VBA-példa
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.
Ez a példa egy dátumot vesz fel, és a DatePart függvény használatával megjeleníti az év azon negyedévét, amelyben bekövetkezik.
Dim TheDate As Date ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg