VBScript. Функция DateDiff

Материал из GedeminWiki
Перейти к: навигация, поиск

Функция возвращает количество временных интервалов между указанными датами.

 DateDiff(interval, date1, date2, [,firstdayofweek[, firstweekofyear]])
interval 
Временной интервал. Строковая константа. Список возможных значений приведен выше в описании функции DateAdd.
date1,date2 
Даты, между которыми вычисляется промежуток.
firstdayofweek 
Опциональный параметр. Определяет с какого дня начинается неделя. Если опущен – первым днем считается воскресенье. Возможные значения приведены в разделе Константы.
firstweekofyear 
Опциональный параметр. Показывает, какая неделя в году считается первой. Если опущен, то таковой будет неделя на которую приходится 1-е января. Возможные значения параметра приведены в разделе Константы.

Данная функция используется для вычисления величины периода между двумя датами. С ее помощью можно получить ответы на такие вопросы, как: сколько дней прошло между двумя датами или сколько недель осталось до конца текущего года.

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

Если date1 содержит более позднюю дату, чем date2, результат будет отрицательным значением.

Параметр firstdayofweek определяет как будут трактоваться символы "w" и "ww".

Допускается для параметров date1 и date2 указать только месяц и день. В этом случае будет подставлен текущий год. Например, следующий вызов функции вычисляет количество дней между 28-м февраля и первым марта для текущего года:

 Days = DateDiff("d", "02/28", "03/01")

В 2004-м году, високосном, переменная Days получит значение 2, а в 2005 и 2006 – 1.

Персональные инструменты
Пространства имён

Варианты
Действия
Навигация
Инструменты