Palauttaa variantin (kokonaisluvun), joka sisältää viikonpäivää edustavan kokonaisluvun.
Syntaksi
Viikonpäivä(päivämäärä [, viikon ensimmäinen päivä ] )
Viikonpäivä-funktion syntaksilla on seuraavat argumentit:
| Argumentti | Kuvaus |
|---|---|
| Päivämäärä | Pakollinen. Variantti, numeerinen lauseke, merkkijonolauseke tai mikä tahansa näiden yhdistelmä, joka voi esittää päivämäärän. Jos päivämäärä sisältää tyhjäarvon, funktio palauttaa tyhjäarvon . |
| viikonensimmäinenpäivä | Valinnainen. Vakio, joka määrittää viikon ensimmäisen päivän. Jos tätä argumenttia ei määritetä, oletusasetus on vbSunday. |
Asetukset
Viikonensimmäinenpäivä -argumentilla on seuraavat asetukset:
| Vakio | Arvo | Kuvaus |
|---|---|---|
| vbUseSystem | 0 | Käytä NLS API -asetusta. |
| vbSunday | 1 | Sunnuntai (oletus) |
| vbMonday | 2 | Maanantai |
| vbTuesday | 3 | Tiistai |
| vbWednesday | 4 | Keskiviikko |
| vbThursday | 5 | Torstai |
| vbFriday | 6 | Perjantai |
| vbSaturday | 7 | Lauantai |
Palautusarvot
Viikonpäivä-funktio voi palauttaa seuraavia arvoja:
| Vakio | Arvo | Kuvaus |
|---|---|---|
| vbSunday | 1 | Sunnuntai |
| vbMonday | 2 | Maanantai |
| vbTuesday | 3 | Tiistai |
| vbWednesday | 4 | Keskiviikko |
| vbThursday | 5 | Torstai |
| vbFriday | 6 | Perjantai |
| vbSaturday | 7 | Lauantai |
Huomautuksia
Jos Calendar-ominaisuusasetus on gregoriaaninen, palautettu kokonaisluku edustaa päivämääräargumentin gregoriaanista viikonpäivää. Jos kalenteri on Hijri, palautettu kokonaisluku vastaa päivämääräargumentin viikon hijri-päivää. Hijri-päivämäärien argumenttinumero on mikä tahansa numeerinen lauseke, joka voi esittää päivämäärän ja/tai kellonajan väliltä 1.1.100 (gregoriaaninen 2. elokuuta 718) ja 3.4.9666 (gregoriaaninen joulukuu 31, 9999).
Esimerkkejä kyselystä
| Lauseke | Tulokset |
|---|---|
| SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales; | Palauttaa arvot kentästä "DateofSale" ja luvun, joka vastaa näiden päivämääräarvojen viikonpäivää. (Oletusarvoisesti sunnuntaita pidetään viikon ensimmäisenä päivänä; 1). |
| SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales; | Palauttaa arvot kentästä "DateofSale" ja luvun, joka vastaa näiden päivämääräarvojen viikonpäivää. (pidetään maanantaita viikon ensimmäisenä päivänä). |
VBA-esimerkki
Huomautus
Seuraavissa esimerkeissä kerrotaan, kuinka tätä funktiota käytetään Visual Basic for Applications (VBA) -moduulissa. Jos haluat lisätietoja VBA:n käytöstä, valitse Sovelluskehittäjän opasHaku-kentän viereisestä luettelosta ja anna yksi tai useampi hakuehto hakukenttään.
Tässä esimerkissä viikonpäivä-funktiolla saadaan viikonpäivä määritetystä päivämäärästä.
Dim MyDate, MyWeekDay
MyDate = #February 12, 1969# ' Assign a date.
MyWeekDay = Weekday(MyDate)
' MyWeekDay contains 4 because
' MyDate represents a Wednesday.