A dátum adott részét tartalmazó Variant (egész) értéket ad eredményül.
|
Figyelmeztetés Probléma van a függvény használatával. Az utolsó hétfőn néhány naptári évben visszaadható a hét 53, amikor a hét 1. További tudnivalókért és a kerülő megoldásért lásd: a formátum vagy a DatePart függvény helytelen hét számot adhat vissza az utolsó hétfőn. |
Szintaxis
DatePart ( időtartomány, dátum [, firstdayofweek] [, firstweekofyear] )
A DatePart függvény argumentumai a következők:
argumentumok | Leírás |
|---|---|
|
intervallum |
Kötelező. Karakterlánc-kifejezés, amely a visszaadott időintervallumot adja meg. |
|
date |
Kötelező megadni. A kiértékelni kívánt Variant (dátum) érték. |
|
hét_első_napja |
Megadása 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 |
A firstweekofyear 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ékelheti a dátumot, és adott időintervallumot adhat eredményül. Használhatja például a DatePart a hét napja vagy az aktuális óra kiszámításához.
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 datedátumkonstans, akkor a megadott év az adott év állandó részévé válik. Ha azonban a dátum dupla idézőjelek ("") közé van zárva, és kihagyja az évet, a program minden alkalommal beszúrja a kódot az aktuális évre a Date kifejezés kiértékelése alkalmával. Így írhat olyan kódot is, amely különböző években is használható.
Megjegyzés: Ha a Naptár tulajdonság beállítása Gergely-naptár, a megadott dátumnak Gergely-naptárnak kell lennie. Iszlám naptár használata esetén a megadott dátumnak az iszlám naptár szerintinek kell lennie.
A visszaadott dátum rész az aktuális Arab naptár időszakos 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.
Lekérdezési példák
Kifejezés | Eredmény: |
|---|---|
|
Válassza a DatePart ("éééé", [DateofSale]) NewDate a ProductSales-től; |
A "DateofSale" mező dátumérték "Year" (év) értékét számítja ki. |
|
Válassza a DatePart ("q", [DateofSale]) NewDate a ProductSales-től; |
A "DateofSale" mező dátum értékeinek "negyedév" (naptári év alapján) értékét számítja ki. |
|
Válassza a DatePart ("y", [DateofSale]) NewDate a ProductSales-től; |
Az "év napja" (1 – 365) értéket számítja ki a "DateofSale" mező dátumaként. |
|
Válassza a DatePart ("d", [DateofSale]) NewDate a ProductSales-től; |
A "DateofSale" mező dátumérték "Day" (nap) értékét számítja ki. |
|
Válassza a DatePart ("w", [DateofSale]) NewDate a ProductSales-től; |
A "DateofSale" mező dátum értékeinek "hét" (1 – 7) értékét számítja ki. |
|
Válassza a DatePart ("ww", [DateofSale]) NewDate az ProductSales-től; |
A "DateofSale" mező dátum értékeinek értékét (1-től 52-ig) számítja ki. |
|
Válassza a DatePart ("h", [DateTime]) NewDate a ProductSales-ból. |
A "DateTime" mező dátumérték "óra" értékét számítja ki. |
|
Válassza a DatePart ("n", [DateTime]) NewDate a ProductSales-ból. |
A "DateTime" mező dátumérték "perc" értékét számítja ki. |
|
Válassza a DatePart ("s", [DateTime]) NewDate a ProductSales-ból. |
A "DateTime" mező dátumérték "másodperc" értékét számítja ki. |
Példa VBA-ként
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 jelenít meg, és a DatePart függvény segítségével megjeleníti annak az évnek a negyedévét, amelyben az esemény bekövetkezik.
Dim TheDate As Date ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg
