vba excel день недели
Функция WeekdayName
Возвращает строку, в которой указан определенный день недели.
Синтаксис
WeekdayName(weekday, abbreviate, firstdayofweek)
Синтаксис функции WeekdayName содержит следующие элементы:
| Part | Описание |
|---|---|
| будний день | Обязательный. Числовое обозначение дня недели. Числовое значение каждого дня зависит от установки параметра для firstdayofweek. |
| аббревиатура | Необязательное. Значение типа Boolean, которое указывает, нужно ли сокращать день недели. Если не указано, по умолчанию задается значение False, которое означает, что название дня недели не сокращается. |
| первый_день_недели | Необязательный аргумент. Числовое значение, указывающее на первый день недели. Значения см. в разделе параметров. |
Параметры
Аргумент firstdayofweek может иметь следующие значения:
| Константа | Значение | Описание |
|---|---|---|
| vbUseSystem | 0 | Значение, используемое по умолчанию. Использование параметра API многоязыковой поддержки. |
| vbSunday | 1 | Воскресенье |
| vbMonday | 2 | Понедельник |
| vbTuesday | 3 | Вторник |
| vbWednesday | 4 | Среда |
| vbThursday | 5 | Четверг |
| vbFriday | 6 | Пятница |
| vbSaturday | 7 | Суббота |
См. также
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.
Функция Weekday
Возвращает значение переменной Variant (Integer), отображающее дни недели.
Синтаксис
Будний день (дата, [ firstdayofweek ])
Синтаксис функции Weekday состоит из таких именованных аргументов:
| Part | Описание |
|---|---|
| дата | Обязательный аргумент. Переменная, числовое выражение, строковое выражение или любое выражение, отображающее дату. Если аргумент 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 григорианский, возвращенный integer представляет григорианский день недели для аргумента даты.
Если задан календарь хиджра, возвращаемое целое число означает день недели по календарю хиджра, соответствующий аргументу date. Для дат по календарю хиджра числовым аргументом является любое числовое выражение, представляющее дату или время с 1 января 100 года (2 августа 718 года по грегорианскому календарю) по 4 марта 9666 года (31 декабря 9999 года по грегорианскому календарю).
Пример
В этом примере функция Weekday возвращает день недели по указанной дате.
См. также
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.
VBA Excel. Функции для работы с датой и временем
Функции для работы с датой и временем в VBA Excel. Синтаксис, параметры, спецсимволы, примеры. Функции, возвращающие текущие дату и время по системному таймеру.
Функция Date
Синтаксис
Пример
Функция DateAdd
Синтаксис
Параметры
| Параметр | Описание |
|---|---|
| interval | Обязательный параметр. Строковое выражение из спецсимволов, представляющее интервал времени, который требуется добавить. |
| number | Обязательный параметр. Числовое выражение, задающее количество интервалов, которые необходимо добавить. Может быть как положительным (возвращается будущая дата), так и отрицательным (возвращается предыдущая дата). |
| date | Обязательный параметр. Значение типа Variant/Date или литерал, представляющий дату, к которой должен быть добавлен интервал. |
Таблицу аргументов (значений) параметра interval смотрите в параграфе «Приложение 1».
Примечание к таблице аргументов: три символа – y, d, w – указывают функции DateAdd на один день, который необходимо прибавить к исходной дате number раз.
Пример
Функция DateDiff
Синтаксис
Параметры
Таблицу аргументов (значений) параметра interval смотрите в параграфе «Приложение 1».
Параметры firstdayofweek и firstweekofyear определяют правила расчета количества недель между датами.
Таблицы констант из коллекций firstdayofweek и firstweekofyear смотрите в параграфах «Приложение 2» и «Приложение 3».
Функция Weekday
Возвращает значение Variant ( Integer), содержащее целое число, соответствует дню недели.
Функция Weekday имеет следующие аргументы:
Обязательный аргумент. Variant, числовое выражение, строковое выражение или любое сочетание этих вариантов, которые могут представлять дату. Если дата содержит NULL, возвращается NULL.
Необязательный аргумент. Константа, задающая первый день недели. Если не указано, предполагается vbSunday.
Аргумент первый_день_недели может принимать следующие значения:
Используются параметры API NLS.
Воскресенье (по умолчанию)
Функция Weekday возвращает одно из следующих значений:
Если свойство Calendar имеет значение Gregorian, возвращаемое целое значение представляет собой день недели по григорианскому календарю. Если задан календарь Hijri, то будет возвращен день недели по календарю Хиджра. Для дат по календарю Хиджра аргумент может быть любым числовым выражением, которое обозначает дату и время от 01.01.100 (2 августа 718 г. по григорианскому календарю) до 03.04.9666 (31 декабря 9999 г. по григорианскому календарю).
Примеры запросов
SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales;
Возвращает значения из поля «ДатаofSale» и число, представляющее «День Недели» этих значений дат. (По умолчанию воскресенье считается первым днем недели; 1).
SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales;
Возвращает значения из поля «ДатаofSale» и число, представляющее «День Недели» этих значений дат. (понедельник — это первый день недели).
Пример VBA
Примечание: В примерах ниже показано, как использовать эту функцию в модуле Visual Basic для приложений (VBA). Чтобы получить дополнительные сведения о работе с VBA, выберите Справочник разработчика в раскрывающемся списке рядом с полем Поиск и введите одно или несколько слов в поле поиска.
В этом примере с помощью функции Weekday определяется день недели для указанной даты.
Weekday function
Returns a Variant (Integer) containing a whole number representing the day of the week.
Syntax
Weekday(date, [ firstdayofweek ])
The Weekday function syntax has these named arguments:
| Part | Description |
|---|---|
| date | Required. Variant, numeric expression, string expression, or any combination, that can represent a date. If date contains Null, Null is returned. |
| firstdayofweek | Optional. A constant that specifies the first day of the week. If not specified, vbSunday is assumed. |
Settings
The firstdayofweek argument has these settings:
| Constant | Value | Description |
|---|---|---|
| vbUseSystem | 0 | Use the NLS API setting. |
| vbSunday | 1 | Sunday (default) |
| vbMonday | 2 | Monday |
| vbTuesday | 3 | Tuesday |
| vbWednesday | 4 | Wednesday |
| vbThursday | 5 | Thursday |
| vbFriday | 6 | Friday |
| vbSaturday | 7 | Saturday |
Return values
The Weekday function can return any of these values:
| Constant | Value | Description |
|---|---|---|
| vbSunday | 1 | Sunday |
| vbMonday | 2 | Monday |
| vbTuesday | 3 | Tuesday |
| vbWednesday | 4 | Wednesday |
| vbThursday | 5 | Thursday |
| vbFriday | 6 | Friday |
| vbSaturday | 7 | Saturday |
Remarks
If the Calendar property setting is Gregorian, the returned integer represents the Gregorian day of the week for the date argument.
If the calendar is Hijri, the returned integer represents the Hijri day of the week for the date argument. For Hijri dates, the argument number is any numeric expression that can represent a date and/or time from 1/1/100 (Gregorian Aug 2, 718) through 4/3/9666 (Gregorian Dec 31, 9999).
Example
This example uses the Weekday function to obtain the day of the week from a specified date.
See also
Support and feedback
Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.