Возвращает значение типа Variant (Long), указывающее число временных интервалов между двумя датами.

Синтаксис

DateDiff(interval, date1, date2[, firstdayofweek[, firstweekofyear]])

Синтаксис функции DateDiff содержит следующие именованные аргументы:

Элемент	Описание
interval	Обязательный.  Строковое выражение, указывающее тип временного интервала, который следует использовать при вычислении разности между датами date1 и date2.
date1, date2	Обязательные.  Значения типа Variant (Date).  Две даты, разность между которыми следует вычислить.
firstdayofweek	Необязательный.  Константа, указывающая первый день недели.  Если этот аргумент опущен, считается, что неделя начинается с воскресенья.
firstweekofyear	Необязательный.  Константа, указывающая первую неделю года.  Если этот аргумент опущен, первой неделей считается неделя, содержащая  1  января.
Значения

Ниже перечислены допустимые значения аргумента interval:

Значение	Описание
yyyy	Год.
q	Квартал.
m	Месяц.
y	День года.
d	День месяца.
w	День недели.
ww	Неделя.
h	Часы.
n	Минуты.
s	Секунды.
Ниже перечислены допустимые значения аргумента firstdayofweek:

Константа	Значение	Описание
vbUseSystem	 0 	Используется значение NLS API.
VbSunday	 1 	Воскресенье (по умолчанию).
VbMonday	 2 	Понедельник.
VbTuesday	 3 	Вторник.
VbWednesday	 4 	Среда.
VbThursday	 5 	Четверг.
VbFriday	 6 	Пятница.
VbSaturday	 7 	Суббота.
Ниже перечислены допустимые значения аргумента firstweekofyear:

Константа	Значение	Описание
vbUseSystem	 0 	Используется значение NLS API.
VbFirstJan1	 1 	Неделя, которая содержит  1  января (по умолчанию).
VbFirstFourDays	 2 	Первая неделя, которая содержит по крайней мере четыре дня нового года.
VbFirstFullWeek	 3 	Первая полная неделя года.
Дополнительные сведения

Функция DateDiff предназначена для определения числа указанных временных интервалов между двумя датами.  Например, с помощью этой функции можно вычислить число дней между двумя датами или число недель между текущей датой и концом года.
Для вычисления числа дней между датами date1 и date2 можно использовать временные интервалы типа день года ("y") или день месяца ("d").  Если interval задается как день недели ("w"), возвращается число недель между двумя датами.  Если date1 соответствует понедельнику, подсчитывается число понедельников между date1 и date2.  При этом date2 учитывается, а date1 нет.  Если interval задается в неделях ("ww"), функция DateDiff возвращает число календарных недель между двумя датами, т.е. число воскресений между date1 и date2.  При этом дата date2 учитывается (если ей соответствует воскресенье), а date1 нет (даже если ей соответствует воскресенье).

Если date1 определяет дату, более позднюю, чем date2, возвращается отрицательное значение.
Аргумент firstdayofweek влияет на вычисления, использующие временные интервалы типа "w" и "ww".
Если дата задается как литерал даты, указанный год становится постоянной частью даты.  Однако если дата заключается в прямые кавычки (" "), а год опущен, то при каждом вычислении выражения даты в него будет подставляться текущий год.  Это позволяет написать код, который может использоваться в течение нескольких лет.

При сравнении дат  31  декабря и  1  января следующего года функция DateDiff для интервала типа год ("yyyy") возвращает значение  1 , хотя разница между датами составляет всего один день.