Tagastab variandi (täisarvu), mis sisaldab nädalapäeva tähistavat täisarvu.
Süntaks
Weekday(date [, firstdayofweek ] )
Funktsiooni Weekday süntaksil on järgmised argumendid.
| Argument | Kirjeldus |
|---|---|
| Kuupäev | Nõutav. Variant, arvuline avaldis, stringiavaldis või nende kombinatsioon, mis võib tähistada kuupäeva. Kui date sisaldab tühiväärtust, tagastatakse tühiväärtus . |
| firstdayofweek | Valikuline. Nädala esimest päeva määrav konstant. Kui seda pole määratud, eeldatakse vbSundayt . |
Sätted
Argumendil firstdayofweek on järgmised sätted.
| Konstant | Väärtus | Kirjeldus |
|---|---|---|
| vbUseSystem | 0 | Kasutage NLS API sätet. |
| vbSunday | 1 | Pühapäev (vaikeväärtus) |
| vbMonday | 2 | Esmaspäev |
| vbTuesday | 3 | Teisipäev |
| vbWednesday | 4 | Kolmapäev |
| vbThursday | 5 | Neljapäev |
| vbFriday | 6 | Reede |
| vbSaturday | 7 | Laupäev |
Tagastusväärtused
Funktsioon Weekday võib tagastada järgmisi väärtusi.
| Konstant | Väärtus | Kirjeldus |
|---|---|---|
| vbSunday | 1 | Pühapäev |
| vbMonday | 2 | Esmaspäev |
| vbTuesday | 3 | Teisipäev |
| vbWednesday | 4 | Kolmapäev |
| vbThursday | 5 | Neljapäev |
| vbFriday | 6 | Reede |
| vbSaturday | 7 | Laupäev |
Kommentaarid
Kui atribuudi Calendar sätteks on Gregoriuse, tähistab tagastatav täisarv kuupäevaargumendi puhul Gregoriuse nädalapäeva. Kui kalender on Hijri, tähistab tagastatav täisarv kuupäevaargumendi puhul nädala hidžra päeva. Hidžra kuupäevade puhul on argumendi number mis tahes arvuline avaldis, mis tähistab kuupäeva ja/või kellaaega vahemikus 1.01.100 (Gregoriuse 2. aug 718) kuni 3.04.9666 (Gregoriuse 31. dets 9999).
Päringu näited
| Avaldis | Tulemid |
|---|---|
| SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales; | Tagastab välja "DateofSale" ja nende kuupäevaväärtuste nädalapäeva tähistava arvu väärtused. (Vaikimisi käsitletakse pühapäeva nädala esimest päeva; 1). |
| SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales; | Tagastab välja "DateofSale" ja nende kuupäevaväärtuste nädalapäeva tähistava arvu väärtused. (arvestades, et esmaspäev on nädala esimene päev). |
VBA näide
Märkus.
Järgmised näited kujutavad selle funktsiooni kasutamist rakenduse Visual Basic for Applications (VBA) moodulis. Lisateabe saamiseks VBA-ga töötamise kohta valige välja Otsing kõrval kuvatavast ripploendist väärtus Tootearendusmaterjal ja sisestage otsinguväljale üks või mitu sõna.
Selles näites kasutatakse funktsiooni Weekday ja tuletatakse kuupäevast nädalapäev.
Dim MyDate, MyWeekDay
MyDate = #February 12, 1969# ' Assign a date.
MyWeekDay = Weekday(MyDate)
' MyWeekDay contains 4 because
' MyDate represents a Wednesday.