Функция Weekday

Статья
04/07/2023

Возвращает значение переменной Variant (Integer), отображающее дни недели.

Синтаксис

Weekday(date, [ firstdayofweek ])

Синтаксис функции Weekday состоит из таких именованных аргументов:

Part	Описание
дата	Обязательный аргумент. Переменная, числовое выражение, строковое выражение или любое выражение, отображающее дату. Если аргумент date содержит Null, возвращается значение Null.
первый_день_недели	Необязательный аргумент. Константа, задающая первый день недели. Если она не указана, им является vbSunday.

Settings

Аргумент первый_день_недели может принимать следующие значения:

Константа	Значение	Описание
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 имеет значение григорианский, возвращаемое целое число представляет григорианский день недели для аргумента date.

Если задан календарь хиджра, возвращаемое целое число означает день недели по календарю хиджра, соответствующий аргументу date. Для дат по календарю хиджра числовым аргументом является любое числовое выражение, представляющее дату или время с 1 января 100 года (2 августа 718 года по грегорианскому календарю) по 4 марта 9666 года (31 декабря 9999 года по грегорианскому календарю).

Пример

В этом примере функция Weekday возвращает день недели по указанной дате.

Dim MyDate, MyWeekDay
MyDate = #February 12, 1969#    ' Assign a date.
MyWeekDay = Weekday(MyDate)    ' MyWeekDay contains 4 because 
    ' MyDate represents a Wednesday.

См. также

Функции (Visual Basic для приложений)

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.

Поделиться через