Возвращает значение Variant (Integer), содержащее целое число, соответствует дню недели.
Синтаксис
Деньнедели(дата [, первыйденьнедели ] )
Функция Weekday имеет следующие аргументы:
| Аргумент | Описание |
|---|---|
| дата | — обязательный аргумент. Вариант, числовое выражение, строковое выражение или любое их сочетание, которое может представлять дату. Если дата содержит значение NULL, возвращается значение NULL . |
| первый_день_недели | — необязательный аргумент. Константа, определяющая первый день недели. Если параметр не задан, предполагается значение 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 имеет значение Gregorian, возвращаемое целое значение представляет собой день недели по григорианскому календарю. Если задан календарь Hijri, то будет возвращен день недели по календарю Хиджра. Для дат по календарю Хиджра аргумент может быть любым числовым выражением, которое обозначает дату и время от 01.01.100 (2 августа 718 г. по григорианскому календарю) до 03.04.9666 (31 декабря 9999 г. по григорианскому календарю).
Примеры запросов
| Выражение | Результаты |
|---|---|
| SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales; | Возвращает значения из поля "DateofSale" и число, представляющее "Weekday" для этих значений даты. (По умолчанию первым днем недели считается воскресенье; 1). |
| SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales; | Возвращает значения из поля "DateofSale" и число, представляющее "Weekday" для этих значений даты. (считая понедельник первым днем недели). |
Пример 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.