Функция DateDiff

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

См. примеры

Синтаксис

DateDiff(интервал, дата1, дата2 [, первый_день_недели] [,первая_неделя_года] )

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

АРГУМЕНТ	ОПИСАНИЕ
интервал	Обязательный аргумент. Строковое выражение, являющееся интервалом времени, который используется для вычисления разницы между аргументами дата1 и дата2
дата1, дата2	Обязательные аргументы типа Variant (Date). Две даты, используемые при вычислении
первый_день_недели	Необязательный аргумент. Константа, указывающая первый день недели. Если этот аргумент не указан, первым днем считается воскресенье.
первая_неделя_года	Необязательный аргумент. Константа, указывающая первую неделю года. Если этот аргумент не указан, первой неделей считается неделя, на которую приходится 1 января

Значение

Аргумент интервал имеет следующие значения:

ЗНАЧЕНИЕ	ОПИСАНИЕ
yyyy	Год
q	Квартал
m	Месяц
y	День года
d	День
w	День недели
ww	Неделя
h	Час
n	Минута
s	Секунда

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

КОНСТАНТА	ЗНАЧЕНИЕ	ОПИСАНИЕ
vbUseSystem	0	Используются параметры API многоязыковой поддержки
vbSunday	1	Воскресенье (по умолчанию)
vbMonday	2	Понедельник
vbTuesday	3	Вторник
vbWednesday	4	Среда
vbThursday	5	Четверг
vbFriday	6	Пятница
vbSaturday	7	Суббота
КОНСТАНТА	ЗНАЧЕНИЕ	ОПИСАНИЕ
vbUseSystem	0	Используются параметры API многоязыковой поддержки
vbFirstJan1	1	Первой неделей считается та, на которую приходится 1 января (по умолчанию)
vbFirstFourDays	2	Первой неделей считается та, которая содержит хотя бы четыре дня нового года
vbFirstFullWeek	3	Первой неделей считается первая полная неделя года

Замечания

Функция DateDiff используется для определения числа интервалов времени между двумя датами. Например, DateDiff можно использовать для вычисления числа дней между двумя датами или числа недель между сегодняшним днем и концом года.

Для вычисления числа дней между аргументами дата1 и дата2используется значение «День года» ("y") или «День» ("d"). Если интервалзадан как «День недели» ("w"), DateDiff возвращает число недель между двумя датами. Если день дата1 приходится на понедельник, DateDiff считает число понедельников до дня дата2. День, соответствующий значению аргумента дата2, учитывается, а дата1 — нет. Однако если интервал задан как «Неделя» ("ww"), функция DateDiff возвращает число календарных недель между двумя датами. Для этого рассчитывается число воскресений между днями дата1 и дата2. DateDiff учитывает день дата2, если он приходится на воскресенье; день дата1 не учитывается, даже если он приходится на воскресенье.

Если значение дата1 соответствует более поздней дате, чем значениедата2, функция DateDiff возвращает отрицательное число.

Аргумент первый_день_недели влияет на вычисления, если заданы значения "w" и "ww".

Если аргумент дата1 или дата2 содержит литералы даты, указанный год становится постоянной частью этой даты. Однако если аргумент дата1 илидата2 заключен в двойные прямые кавычки (" "), а год опущен, при каждой оценке выражения дата1 или дата2 в код подставляется текущий год. Это позволяет писать код, который можно использовать для разных годов.

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

 ПРИМЕЧАНИЕ.    Если в свойстве Calendar задано григорианское летоисчисление, аргументы дата1 и дата2 следует указывать соответствующим образом. Если используется календарь хиджра, дата должна соответствовать календарю хиджра.