Возвращает значение Variant (Integer), содержащее целое число, соответствует дню недели.
Синтаксис
Weekday( дата [, первый_день_недели ] )
Функция Weekday имеет следующие аргументы:
|
Аргумент |
Описание |
|
дата |
Обязательный аргумент. Variant, числовое выражение, строковое выражение или любое их сочетание, которое может представлять дату. Если date содержит значение NULL, возвращается значение NULL . |
|
первый_день_недели |
Необязательный аргумент. Константа, задающая первый день недели. Если значение не указано, предполагается vbSunday . |
Параметры
Аргумент первый_день_недели может принимать следующие значения:
|
Константа |
Значение |
Описание |
|
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 имеет значение Gregorian, возвращаемое целое значение представляет собой день недели по григорианскому календарю. Если задан календарь Hijri, то будет возвращен день недели по календарю Хиджра. Для дат по календарю Хиджра аргумент может быть любым числовым выражением, которое обозначает дату и время от 01.01.100 (2 августа 718 г. по григорианскому календарю) до 03.04.9666 (31 декабря 9999 г. по григорианскому календарю).
Примеры запросов
|
Expression |
Результаты |
|
SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales; |
Возвращает значения из поля DateofSale и число, представляющее "День недели" этих значений даты. (По умолчанию воскресенье считается первым днем недели; 1). |
|
SELECT DateofSale, Weekday([DateofSale];2) AS NewWeekDay FROM ProductSales; |
Возвращает значения из поля DateofSale и число, представляющее "День недели" этих значений даты. (считая понедельник первым днем недели). |
Пример VBA
Примечание: В примерах ниже показано, как использовать эту функцию в модуле Visual Basic для приложений (VBA). Чтобы получить дополнительные сведения о работе с VBA, выберите Справочник разработчика в раскрывающемся списке рядом с полем Поиск и введите одно или несколько слов в поле поиска.
В этом примере с помощью функции Weekday определяется день недели для указанной даты.
Dim MyDate, MyWeekDay
MyDate = #February 12, 1969# ' Assign a date.
MyWeekDay = Weekday(MyDate)
' MyWeekDay contains 4 because
' MyDate represents a Wednesday.
