Zwraca wartość typu wariant (liczba całkowita) zawierającą liczbę całkowitą odpowiadającą dniu tygodnia.
Składnia
Weekday(data [, pierwszy_dzień_tygodnia ] )
W składni funkcji Dzień powszedni występują następujące argumenty:
| Argument | Opis |
|---|---|
| Data | Argument wymagany. Wariant, wyrażenie liczbowe, wyrażenie ciągu lub dowolna kombinacja tych wartości, które mogą reprezentować datę. Jeśli argument data zawiera wartość Null, funkcja zwraca wartość Null . |
| Firstdayofweek | Argument opcjonalny. Stała określająca pierwszy dzień tygodnia. Jeśli nie określono, przyjmuje się, że vbSunday . |
Ustawienia
Argument pierwszy_dzień_tygodnia zawiera następujące ustawienia:
| Stała | Wartość | Opis |
|---|---|---|
| vbUseSystem | 0 | Użyj ustawienia interfejsu API NLS. |
| vbSunday | 1 | Niedziela (domyślnie) |
| vbMonday | 2 | Poniedziałek |
| vbTuesday | 3 | Wtorek |
| vbWednesday | 4 | Środa |
| vbThursday | 5 | Czwartek |
| vbFriday | 6 | Piątek |
| vbSaturday | 7 | Sobota |
Zwracane wartości
Funkcja Dzień powszedni może zwrócić dowolną z tych wartości:
| Stała | Wartość | Opis |
|---|---|---|
| vbSunday | 1 | Niedziela |
| vbMonday | 2 | Poniedziałek |
| vbTuesday | 3 | Wtorek |
| vbWednesday | 4 | Środa |
| vbThursday | 5 | Czwartek |
| vbFriday | 6 | Piątek |
| vbSaturday | 7 | Sobota |
Uwagi
Jeśli ustawieniem właściwości Calendar jest gregoriański, zwrócona liczba całkowita oznacza dzień tygodnia gregoriański dla argumentu daty. Jeśli kalendarz to Hidżry, zwrócona liczba całkowita oznacza dzień tygodnia Hidżry dla argumentu data. W przypadku dat Hidżry numer argumentu jest dowolnym wyrażeniem liczbowym, które może reprezentować datę i/lub godzinę od 1-01-100 (gregoriański 2 sierpnia 718) do 03.04.9666 (gregoriański 31 grudnia 9999).
Przykłady zapytań
| Wyrażenie | Rezultat |
|---|---|
| SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales; | Zwraca wartości z pola "DateofSale" i liczbę reprezentującą "Dzień tygodnia" tych wartości dat. (Domyślnie niedziela jest uznawana za pierwszy dzień tygodnia; 1). |
| SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales; | Zwraca wartości z pola "DateofSale" i liczbę reprezentującą "Dzień tygodnia" tych wartości dat. (uznając poniedziałek za pierwszy dzień tygodnia). |
Przykład języka VBA
Uwaga
Poniższe przykłady przedstawiają sposób użycia tej funkcji w module języka Visual Basic for Applications (VBA). Aby uzyskać dodatkowe informacje na temat pracy w języku VBA, wybierz pozycję Dokumentacja dewelopera z listy rozwijanej obok przycisku Wyszukaj i wprowadź odpowiednie terminy w polu wyszukiwania.
W tym przykładzie użyto funkcji Dzień powszedni w celu uzyskania dnia tygodnia od określonej daty.
Dim MyDate, MyWeekDay
MyDate = #February 12, 1969# ' Assign a date.
MyWeekDay = Weekday(MyDate)
' MyWeekDay contains 4 because
' MyDate represents a Wednesday.