A hét napját jelentő egész számot tartalmazó Variant (egész) értéket ad eredményül.
Szintaxis
Weekday(dátum [, hétkezdő_nap ] )
A Hét.NAPJA függvény szintaxisa az alábbi argumentumokat foglalja magában:
| Argumentum | Leírás: |
|---|---|
| dátum | Kötelező megadni. Variáns, numerikus kifejezés, karakterlánc, illetve ezek tetszőleges kombinációja, amely megadhat egy dátumot. Ha a dátum Null értéket tartalmaz, a visszatérési érték is Null lesz . |
| hét_első_napja | Nem kötelező. A hét első napját megadó állandó. Ha nincs megadva, akkor vbSunday feltételezett. |
Beállítások
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 |
Visszatérési értékek
A Weekday függvény az alábbi értékek bármelyikét visszaadhatja:
| Állandó | Érték | Leírás: |
|---|---|---|
| vbSunday | 1 | vasárnap |
| vbMonday | 2 | Hétfő |
| vbTuesday | 3 | Kedd |
| vbWednesday | 4 | Szerda |
| vbThursday | 5 | Csütörtök |
| vbFriday | 6 | Péntek |
| vbSaturday | 7 | Szombat |
Megjegyzések
Ha a Calendar tulajdonság értéke Gergely-naptár, a visszaadott egész szám a hét Gergely-naptár szerinti napját jelzi a dátum argumentumban. Ha a naptár iszlám naptár, a visszaadott egész szám a hét Iszlám Naptár (Dátum) argumentumában megadott napját jelenti. Az iszlám dátumok argumentuma a szám argumentum tetszőleges numerikus kifejezés, amely a 20100. január 1. (718. Gergely-naptár augusztus 2.) és 9666. 04. 03. (Gergely-naptár 9999. december 31.) közötti dátumnak felel meg.
Példák lekérdezésekre
| Expression (Kifejezés) | Eredmény: |
|---|---|
| SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales; | Az "Értékesítés_dátuma" mező értékeit és az értékek "hét napja" értékét képviselő szám értékét adja vissza. (Alapértelmezés szerint a vasárnap a hét első napja; 1.) |
| SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales; | Az "Értékesítés_dátuma" mező értékeit és az értékek "hét napja" értékét képviselő szám értékét adja vissza. (a hétfőt a hét első napjának tekintve). |
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 a Weekday függvényt használja a hét napjának lekéréséhez egy adott dátumtól.
Dim MyDate, MyWeekDay
MyDate = #February 12, 1969# ' Assign a date.
MyWeekDay = Weekday(MyDate)
' MyWeekDay contains 4 because
' MyDate represents a Wednesday.