Повертає значення типу Variant (Integer), яке містить ціле число, що позначає день тижня.
Синтаксис
Weekday(date [, firstdayofweek ] )
Синтаксис функції Weekday має такі аргументи:
| Аргумент | Опис |
|---|---|
| Дата | — обов’язковий аргумент. Варіант, числовий вираз, рядковий вираз або будь-яка їх комбінація, яка може представляти дату. Якщо дата містить Null-значення, повертається значення Null . |
| firstdayofweek | — необов’язковий аргумент. Константа, яка визначає перший день тижня. Якщо не вказано, приймається значення vbSunday . |
Параметри
Аргумент firstdayofweek має такі параметри:
| Константа | Значення | Опис |
|---|---|---|
| vbUseSystem | 0 | Використовуйте параметр API NLS. |
| vbSunday | 1 | Неділя (за замовчуванням) |
| vbMonday | 2 | Понеділок |
| vbTuesday | 3 | Вівторок |
| vbWednesday | 4 | Середа |
| vbThursday | 5 | Четвер |
| vbFriday | 6 | П’ятниця |
| vbSaturday | 7 | Субота |
Значення, що повертаються
Функція Weekday може повертати будь-яке з таких значень:
| Константа | Значення | Опис |
|---|---|---|
| vbSunday | 1 | Неділя |
| vbMonday | 2 | Понеділок |
| vbTuesday | 3 | Вівторок |
| vbWednesday | 4 | Середа |
| vbThursday | 5 | Четвер |
| vbFriday | 6 | П’ятниця |
| vbSaturday | 7 | Субота |
Примітки
Якщо значення властивості Calendar григоріанське, повернуте ціле число представляє григоріанський день тижня для аргументу дата. Якщо календар – хіджри, повернуте ціле число представляє день тижня Хіджра для аргументу дата. Для дат Хіджра число аргументу – це будь-який числовий вираз, який може представляти дату та/або час від 01.01.100 (григоріанський календар від 2 серпня 718 р.) до 3.04.9666 (григоріанський грудень 31, 9999).
Приклади запитів
| Вираз | Результати. |
|---|---|
| SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales; | Повертає значення з поля "DateofSale" і число, що позначає "День тижня" цих значень дат. (За замовчуванням неділя вважається першим днем тижня; 1). |
| SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales; | Повертає значення з поля "DateofSale" і число, що позначає "День тижня" цих значень дат. (розглядаємо понеділок як перший день тижня). |
Приклад VBA
Примітка.
У прикладах нижче показано використання цієї функції в модулі Visual Basic for Applications (VBA). Щоб отримати докладні відомості про використання модуля VBA, клацніть пункт Довідник розробника в розкривному списку поряд із полем Пошук і введіть у поле пошуку принаймні один термін.
У цьому прикладі використано функцію Weekday , щоб отримати день тижня з указаної дати.
Dim MyDate, MyWeekDay
MyDate = #February 12, 1969# ' Assign a date.
MyWeekDay = Weekday(MyDate)
' MyWeekDay contains 4 because
' MyDate represents a Wednesday.