Zwraca wartość typu wariant (liczba całkowita) zawierającą liczbę całkowitą odpowiadającą dniu tygodnia.
Składnia
Weekday(date [, first_day_week])
W składni funkcji Dzień tyg. występują następujące argumenty:
| Argumenty argumentów | Opis |
|---|---|
| DATA | Argument wymagany. Wariant, wyrażenie liczbowe, wyrażenie ciągu lub dowolna kombinacja tych wyrażeń, która może oznaczać datę. Jeśli data zawiera wartość null, funkcja zwraca wartość null . |
| pierwszy dzień tygodnia | Argument opcjonalny. Stała określająca pierwszy dzień tygodnia. Jeśli nie zostanie określony, przyjmuje się, że jest to vbSunday . |
Ustawienia
Argument pierwszy_dzień_tygodnia ma następujące ustawienia:
| Stała | Wartość | Opis |
|---|---|---|
| vbUseSystem | 0 | Użyj ustawienia interfejsu API funkcji NLS. |
| vbSunday | 1 | Niedziela (domyślnie) |
| vbMonday | 2 | Poniedziałek |
| vbwtorek | 3 | Wtorek |
| vbWednesday | 4 | Środa |
| vbczwartek | 5 | Czwartek |
| vbFriday | 6 | Piątek |
| vbSaturday | 7 | Sobota |
Wartości zwracane
Funkcja Weekday (dzień.tyg) może zwrócić dowolną z następujących wartości:
| Stała | Wartość | Opis |
|---|---|---|
| vbSunday | 1 | Niedziela |
| vbMonday | 2 | Poniedziałek |
| vbwtorek | 3 | Wtorek |
| vbWednesday | 4 | Środa |
| vbczwartek | 5 | Czwartek |
| vbFriday | 6 | Piątek |
| vbSaturday | 7 | Sobota |
Uwagi
Jeśli ustawienie właściwości Calendar jest gregoriańskie, zwrócona liczba całkowita reprezentuje gregoriański dzień tygodnia dla argumentu daty. Jeśli kalendarz to kalendarz Hidżra, zwrócona liczba całkowita odpowiada dniowi tygodnia Hidżry dla argumentu daty. W przypadku dat Hidżry numerem argumentu jest dowolne wyrażenie liczbowe, które może reprezentować datę i/lub godzinę od 1/1/100 (kalendarz gregoriański 2 sierpnia 718 r.) do 03.04.9666 r. (31 grudnia 9999 r.).
Przykłady kwerend
| Wyrażenie | Rezultat |
|---|---|
| SELECT DateofSale, Weekday([DateofSale]) AS Wyr1 FROM ProductSales; | Zwraca wartości z pola "DateofSale" i liczbę reprezentującą dzień tygodnia dla 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 dla tych wartości dat. (traktując poniedziałek jako pierwszy dzień tygodnia). |
Przykład kodu 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 Weekday w celu uzyskania dnia tygodnia z określonej daty.
Dim MyDate, MyWeekDay
MyDate = #February 12, 1969# ' Assign a date.
MyWeekDay = Weekday(MyDate)
' MyWeekDay contains 4 because
' MyDate represents a Wednesday.