Функции для работы с датой и временем в VBA Excel. Синтаксис, параметры, спецсимволы, примеры. Функции, возвращающие текущие дату и время по системному таймеру.
Функция Date
Синтаксис
1 |
Date |
Пример
1 2 3 |
Sub PrimerDate() MsgBox "Сегодня: " & Date End Sub |
Функция DateAdd
Синтаксис
1 |
DateAdd(interval, number, date) |
Параметры
Параметр | Описание |
---|---|
interval | Обязательный параметр. Строковое выражение из спецсимволов, представляющее интервал времени, который требуется добавить. |
number | Обязательный параметр. Числовое выражение, задающее количество интервалов, которые необходимо добавить. Может быть как положительным (возвращается будущая дата), так и отрицательным (возвращается предыдущая дата). |
date | Обязательный параметр. Значение типа Variant/Date или литерал, представляющий дату, к которой должен быть добавлен интервал. |
Таблицу аргументов (значений) параметра interval
смотрите в параграфе «Приложение 1».
Примечание к таблице аргументов: три символа – y, d, w – указывают функции DateAdd
на один день, который необходимо прибавить к исходной дате number
раз.
Пример
1 2 3 4 5 6 |
Sub PrimerDateAdd() MsgBox "31.01.2021 + 1 месяц = " & DateAdd("m", 1, "31.01.2021") 'Результат: 28.02.2021 MsgBox "Сегодня + 3 года = " & DateAdd("yyyy", 3, Date) MsgBox "Сегодня - 2 недели = " & DateAdd("ww", -2, Date) MsgBox "10:22:14 + 10 минут = " & DateAdd("n", 10, "10:22:14") 'Результат: 10:32:14 End Sub |
Функция DateDiff
Синтаксис
1 |
DateDiff(interval, date1, date2, [firstdayofweek], [firstweekofyear]) |
Параметры
Параметр | Описание |
---|---|
interval | Обязательный параметр. Строковое выражение из спецсимволов, представляющее интервал времени, количество которых (интервалов) требуется вычислить между двумя датами. |
date1, date2 | Обязательные параметры. Значения типа Variant/Date , представляющие две даты, между которыми вычисляется количество указанных интервалов. |
firstdayofweek | Необязательный параметр. Константа, задающая первый день недели. По умолчанию – воскресенье. |
firstweekofyear | Необязательный параметр. Константа, задающая первую неделю года. По умолчанию – неделя, в которую входит 1 января. |
Таблицу аргументов (значений) параметра interval
смотрите в параграфе «Приложение 1».
Примечание к таблице аргументов: в отличие от функции DateAdd
, в функции DateDiff
спецсимвол "w"
, как и "ww"
, обозначает неделю. Но расчет осуществляется по разному. Подробнее об этом на сайте разработчиков.
Параметры firstdayofweek
и firstweekofyear
определяют правила расчета количества недель между датами.
Таблицы констант из коллекций firstdayofweek
и firstweekofyear
смотрите в параграфах «Приложение 2» и «Приложение 3».
Пример
1 2 3 4 5 6 7 8 |
Sub PrimerDateDiff() 'Даже если между датами соседних лет разница 1 день, 'DateDiff с интервалом "y" покажет разницу - 1 год MsgBox DateDiff("y", "31.12.2020", "01.01.2021") 'Результат: 1 год MsgBox DateDiff("d", "31.12.2020", "01.01.2021") 'Результат: 1 день MsgBox DateDiff("n", "31.12.2020", "01.01.2021") 'Результат: 1440 минут MsgBox "Полных лет с начала века = " & DateDiff("y", "2000", Year(Now) - 1) End Sub |
Функция DatePart
Есть предупреждение по использованию этой функции.
Синтаксис
1 |
DatePart(interval, date, [firstdayofweek], [firstweekofyear]) |
Параметры
Параметр | Описание |
---|---|
interval | Обязательный параметр. Строковое выражение из спецсимволов, представляющее часть даты, которую требуется извлечь. |
date | Обязательные параметры. Значение типа Variant/Date , представляющее дату, часть которой следует извлечь. |
firstdayofweek | Необязательный параметр. Константа, задающая первый день недели. По умолчанию – воскресенье. |
firstweekofyear | Необязательный параметр. Константа, задающая первую неделю года. По умолчанию – неделя, в которую входит 1 января. |
Таблицу аргументов (значений) параметра interval
смотрите в параграфе «Приложение 1». В третьей графе этой таблицы указаны интервалы значений, возвращаемых функцией DatePart
.
Таблицы констант из коллекций firstdayofweek
и firstweekofyear
смотрите в параграфах «Приложение 2» и «Приложение 3».
Пример
1 2 3 4 5 6 |
Sub PrimerDatePart() MsgBox DatePart("y", "31.12.2020") 'Результат: 366 MsgBox DatePart("yyyy", CDate(43685)) 'Результат: 2019 MsgBox DatePart("n", CDate(43685.45345)) 'Результат: 52 MsgBox "День недели по счету сегодня = " & DatePart("w", Now, vbMonday) End Sub |
Функция DateSerial
Синтаксис
1 |
DateSerial(year, month, day) |
Параметры
Параметр | Описание |
---|---|
year | Обязательный параметр типа Integer. Числовое выражение, возвращающее значение от 100 до 9999 включительно. |
month | Обязательный параметр типа Integer. Числовое выражение, возвращающее любое значение (в пределах Integer), а не только от 1 до 12.* |
day | Обязательный параметр типа Integer. Числовое выражение, возвращающее любое значение (в пределах Integer), а не только от 1 до 31.* |
* Функция DateSerial автоматически пересчитывает общее количество дней в полные месяцы и остаток, общее количество месяцев в полные годы и остаток (подробнее в примере).
Пример
1 2 3 4 |
Sub PrimerDateSerial() MsgBox DateSerial(2021, 2, 10) 'Результат: 10.02.2020 MsgBox DateSerial(2020, 1, 400) 'Результат: 03.02.2021 End Sub |
Разберем подробнее строку DateSerial(2020, 1, 400)
:
- 400 дней = 366 дней + 31 день + 3 дня;
- 366 дней = 1 год, так как по условию month:=1, значит февраль 2020 входит в расчет, а в нем – 29 дней;
- 31 день = 1 месяц, так как сначала заполняется январь (по условию month:=1);
- 3 дня – остаток.
В итоге получается:
DateSerial(2020+1, 1+1, 3) = DateSerial(2021, 2, 3)
Функция DateValue
Синтаксис
1 |
DateValue(date) |
Параметр date
– строковое выражение, представляющее дату с 1 января 100 года по 31 декабря 9999 года.
Пример
1 2 3 4 |
Sub PrimerDateValue() MsgBox DateValue("8 марта 2021") 'Результат: 08.03.2021 MsgBox DateValue("17 мая 2021 0:59:15") 'Результат: 17.05.2021 End Sub |
Функция DateValue игнорирует время, указанное в преобразуемой строке, но если время указано в некорректном виде (например, «10:60:60»), будет сгенерирована ошибка.
Функция Day
Синтаксис
1 |
Day(date) |
Параметр date
– любое числовое или строковое выражение, представляющее дату.
Пример
1 2 3 |
Sub PrimerDay() MsgBox Day(Now) End Sub |
Функция IsDate
Синтаксис
1 |
IsDate(expression) |
Параметр expression
– это переменная, возвращающая дату или строковое выражение, распознаваемое как дата или время.
Значение, возвращаемое переменной expression, не должно выходить из диапазона допустимых дат: от 1 января 100 года до 31 декабря 9999 года (для Windows).
Пример
1 2 3 4 5 |
Sub PrimerIsDate() MsgBox IsDate("18 апреля 2021") 'Результат: True MsgBox IsDate("31 февраля 2021") 'Результат: False MsgBox IsDate("4.10.20 11:12:54") 'Результат: True End Sub |
Функция Hour
Синтаксис
1 |
Hour(time) |
Параметр time
– любое числовое или строковое выражение, представляющее время.
Пример
1 2 3 4 |
Sub PrimerHour() MsgBox Hour(Now) MsgBox Hour("22:36:54") End Sub |
Функция Minute
Синтаксис
1 |
Minute(time) |
Параметр time
– любое числовое или строковое выражение, представляющее время.
Пример
1 2 3 4 |
Sub PrimerMinute() MsgBox Minute(Now) MsgBox Minute("22:36:54") End Sub |
Функция Month
Синтаксис
1 |
Month(date) |
Параметр date
– любое числовое или строковое выражение, представляющее дату.
Пример
1 2 3 |
Sub PrimerMonth() MsgBox Month(Now) End Sub |
Функция MonthName
Синтаксис
1 |
MonthName(month, [abbreviate]) |
Параметры
Параметр | Описание |
---|---|
month | Обязательный параметр. Числовое обозначение месяца от 1 до 12 включительно. |
abbreviate | Необязательный параметр. Логическое значение: True – возвращается сокращенное название месяца, False (по умолчанию) – название месяца не сокращается. |
Пример
1 2 3 4 |
Sub PrimerMonthName() MsgBox MonthName(10) 'Результат: Октябрь MsgBox MonthName(10, True) 'Результат: окт End Sub |
Функция Now
Синтаксис
1 |
Now |
Пример
1 2 3 4 5 |
Sub PrimerNow() MsgBox Now MsgBox Day(Now) MsgBox Hour(Now) End Sub |
Функция Second
Синтаксис
1 |
Second(time) |
Параметр time
– любое числовое или строковое выражение, представляющее время.
Пример
1 2 3 4 |
Sub PrimerSecond() MsgBox Second(Now) MsgBox Second("22:30:14") End Sub |
Функция Time
Синтаксис
1 |
Time |
Пример
1 2 3 |
Sub PrimerTime() MsgBox "Текущее время: " & Time End Sub |
Функция TimeSerial
Синтаксис
1 |
TimeSerial(hour, minute, second) |
Параметры
Параметр | Описание |
---|---|
hour | Обязательный параметр типа Integer. Числовое выражение, возвращающее значение от 0 до 23 включительно. |
minute | Обязательный параметр типа Integer. Числовое выражение, возвращающее любое значение (в пределах Integer), а не только от 0 до 59.* |
second | Обязательный параметр типа Integer. Числовое выражение, возвращающее любое значение (в пределах Integer), а не только от 0 до 59.* |
* Функция TimeSerial автоматически пересчитывает общее количество секунд в полные минуты и остаток, общее количество минут в полные часы и остаток (подробнее в примере).
Пример
1 2 3 4 |
Sub PrimerTime() MsgBox TimeSerial(5, 16, 4) 'Результат: 5:16:04 MsgBox TimeSerial(5, 75, 158) 'Результат: 6:17:38 End Sub |
Разберем подробнее строку TimeSerial(5, 75, 158)
:
- 158 секунд = 120 секунд (2 минуты) + 38 секунд;
- 75 минут = 60 минут (1 час) + 15 минут.
В итоге получается:
TimeSerial(5+1, 15+2, 38) = TimeSerial(6, 17, 38)
Функция TimeValue
Синтаксис
1 |
TimeValue(time) |
Параметр time
– строковое выражение, представляющее время с 0:00:00 по 23:59:59 включительно.
Пример
1 2 3 4 |
Sub PrimerTimeValue() MsgBox TimeValue("6:45:37 PM") 'Результат: 18:45:37 MsgBox TimeValue("17 мая 2021 3:59:15 AM") 'Результат: 3:59:15 End Sub |
Функция TimeValue игнорирует дату, указанную в преобразуемой строке, но если дата указана в некорректном виде (например, «30.02.2021»), будет сгенерирована ошибка.
Функция Weekday
Синтаксис
1 |
Weekday(date, [firstdayofweek]) |
Параметры
Параметр | Описание |
---|---|
date | Обязательный параметр. Любое выражение (числовое, строковое), отображающее дату. |
firstdayofweek | Константа, задающая первый день недели. По умолчанию – воскресенье. |
Таблицу констант из коллекции firstdayofweek
смотрите в параграфе «Приложение 2».
Пример
1 2 3 4 |
Sub PrimerWeekday() MsgBox Weekday("23 апреля 2021", vbMonday) 'Результат: 5 MsgBox Weekday(202125, vbMonday) 'Результат: 6 End Sub |
Функция WeekdayName
Синтаксис
1 |
WeekdayName(weekday, [abbreviate], [firstdayofweek]) |
Параметры
Параметр | Описание |
---|---|
weekday | Обязательный параметр. Числовое обозначение дня недели от 1 до 7 включительно. |
abbreviate | Необязательный параметр. Логическое значение: True – возвращается сокращенное название дня недели, False (по умолчанию) – название дня недели не сокращается. |
firstdayofweek | Константа, задающая первый день недели. По умолчанию – воскресенье. |
Таблицу констант из коллекции firstdayofweek
смотрите в параграфе «Приложение 2».
Пример
1 2 3 4 5 |
Sub PrimerWeekdayName() MsgBox WeekdayName(3, True, vbMonday) 'Результат: Ср MsgBox WeekdayName(3, , vbMonday) 'Результат: среда MsgBox WeekdayName(Weekday(Now, vbMonday), , vbMonday) End Sub |
Функция Year
Синтаксис
1 |
Year(date) |
Параметр date
– любое числовое или строковое выражение, представляющее дату.
Пример
1 2 3 |
Sub PrimerYear() MsgBox Year(Now) End Sub |
Приложение 1
Таблица аргументов (значений) параметраinterval
для функций DateAdd
, DateDiff
и DatePart
:
Аргумент | Описание | Интервал значений |
---|---|---|
yyyy | Год | 100 – 9999 |
q | Квартал | 1 – 4 |
m | Месяц | 1 – 12 |
y | День года | 1 – 366 |
d | День месяца | 1 – 31 |
w | День недели | 1 – 7 |
ww | Неделя | 1 – 53 |
h | Часы | 0 – 23 |
n | Минуты | 0 – 59 |
s | Секунды | 0 – 59 |
В третьей графе этой таблицы указаны интервалы значений, возвращаемых функцией DatePart
.
Приложение 2
Константы из коллекции firstdayofweek
:
Константа | Значение | Описание |
---|---|---|
vbUseSystem | 0 | Используются системные настройки |
vbSunday | 1 | Воскресенье (по умолчанию) |
vbMonday | 2 | Понедельник |
vbTuesday | 3 | Вторник |
vbWednesday | 4 | Среда |
vbThursday | 5 | Четверг |
vbFriday | 6 | Пятница |
vbSaturday | 7 | Суббота |
Приложение 3
Константы из коллекции firstweekofyear
:
Константа | Значение | Описание |
---|---|---|
vbUseSystem | 0 | Используются системные настройки. |
vbFirstJan1 | 1 | Неделя, в которую входит 1 января (по умолчанию). |
vbFirstFourDays | 2 | Неделя, в которую входит не менее четырех дней нового года. |
vbFirstFullWeek | 3 | Первая полная неделя года. |
Здравствуйте!
А как правильно перевести целое число секунд в сутки:часы:минуты:секунды?
(или хотя бы отобразить через MsgBox)
Т.е. например, перевести 113745 в 1 сутки 7 часов 35 минут 45 секунд
Использую просто деление, но думаю, что наверняка есть более удобный способ
Спасибо!
Добрый вечер!
Мне удалось создать такую конструкцию:
Работает со значением переменной в интервале от 0 до 2147483646 (max cmBut = max Long — 1).
B ячейке D3 записана дата 30.04.1997
как получить числовое значение без года
т.е. мне надо получить дату 30.04.1900
В числовом значении это будет 121
* формульное решение:
=ДАТА(0;МЕСЯЦ(D3);ДЕНЬ(D3))
DateSerial("1900", Month([D3]), Day([D3]))
спасибо
Здравствуйте!
Дана дата в виде строки в американском формате месяц/день/
год. Нужно переделать ее в русский формат день.месяц.год.
примерное решение —
Format(InputBox("Ввод даты", "Ввод", "01/01/2018"), "dd.mm.yyyy")
Добрый день! Отдаю файл ексель с кодом vba над которым работала пол года руководству. Дополнительные программы для защиты не использую. Код просто под паролем. Возникла идея назначить выполнения макросов до определенной даты. Как вы думаете это хорошая идея? Волнует именно, что руководство «забудет о моей напряженной работе».
Здравствуйте, Татьяна!
Идея очень хорошая, если нет возможности сначала передать демо-вариант с ограниченной функциональностью. Лично мне не приходилось ограничивать работу VBA, но я бы в данной ситуации, как вы и предлагаете, использовал бы ограничение по дате. Возможно, кроме напоминания о необходимости оплаты, я бы еще добавил код, удаляющий один из стандартных модулей. Ограничивающую дату, чтобы не бросалась в глаза, лучше отобразить в виде числа:
Евгений, спасибо вам большое☀️
Здравствуйте!
«Функция Time – это функция, которая возвращает значение текущей системной даты.»
Наверное, всё же времени.
Здравствуйте!
Согласен, была опечатка.
Добрый день!
подскажите пожалуйста, а как перевести Tuesday, March 01 2022 в формат 01.03.2022
Добрый день, Максим!
Для этого есть функция
DateSerial
. Но есть одна проблемка — в русскоязычной версии Excel с помощью конструкцииMonth(CDate("1 " & StringMonth))
можно преобразовать в число только месяц строкой на русском языке. Поэтому для перевода названия месяца в число будем использовать словарь:Евгений, благодарю!
протестировал, работает. но в итоге реализовал через питон.
Здравствуйте, Евгений. Есть старая конструкция кода:
не могу заставить работать эту строку: If Date > #6/11/2022# Then
оставляю файл с необходимой датой, а строка не работает. Захожу в файл, закрываю… не удаляется.
Принудительно запускаю, тогда только удаляет книгу, автоматически — нет.
Здравствуйте, Алексей!
Попробуйте так:
Здравствуйте, Евгений.
Не работает. Такое впечатление, что у меня, библиотека не подключена. Но на сколько я понимаю здесь они не нужны.
Добрый день!
У меня Excel 2016, код работает: книга удаляется, остается только «пустой» экземпляр приложения. Код размещается в модуле книги.
Здравствуйте, Евгений. У меня тоже 2016. Ничего не мог сделать (запустить работу макроса) пока не отправил на другой компьютер и оттуда обратно (свой компьютер я и обновлял, и перезагружал). Как пришёл файл заработал присланный и старые пробные версии файлов в которых был установлен этот код. Не знаю, что было.
Здравствуйте, Евгений. Подскажите как получить текущую дату в американском стиле (22.12.01, привык сохранять файлы/папки с таким именем, для удобной сортировки по времени).
MsgBox Year(Now) & "." & Month(Now) & "." & Day(Now)
результат 2022.12.1 (как оставить только 22 и добавить 0 к числу?)Добрый день, Георгий!
MsgBox Format(Now, "YY.MM.DD")
Здравствуйте, у меня немного иная ситуация, как с ней бороться — не знаю )
Может подскажите как текущую системную дату NOW() конвертировать в UNIX?
Нужно для парсера, примерно что-то в таком виде:
If tralala < Now() Then
Спасибо! )
Спасибо, разобрался )
Добрый день.
Подскажите, как вычислить интервал рабочего времени в минутах между двумя датами с началом и окончанием работы, исключая нерабочее время, выходные, праздники и сокращенные дни.
Спасибо.
Здравствуйте, Виталий!
А где вы собираетесь брать исходные данные для вычисления рабочего времени между двумя датами?
Посмотрите такой вариант.
Добрый день! есть 2 даты: 30.04.2022 и 31.07.2022. Нужно сравнить месяц и год (т.е 04.2022 07.2022). Как правильно записать?
(т.е. 04.2022 07.2022)
Здравствуйте, Марина!
Вот два варианта извлечения месяца и года из даты:
Добрый день, подскажите, как сделать, чтобы после обновления макроса в конкретной ячейке на листе прописывалось время его обновления?
Здравствуйте, Мария!
Вставьте эту строку в ваш макрос перед
End Sub
:Обсуждение закрыто.