| |
Функция DateDiff |
|
| |
Функция DateDiff | | Синтаксис DateDiff(interval, date1, date2[, firstdayofweek[, firstweekofyear]]) | Возвращает значение типа Variant (Long), указывающее число временных интервалов между двумя датами. Функция 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, хотя разница между датами составляет всего один день. | Параметры Наименование | Описание | Interval | Обязательный. Строковое выражение, указывающее тип временного интервала, который следует использовать при вычислении разности между датами date1 и date2.
| Date1, Date2 | Обязательные. Значения типа Variant (Date). Две даты, разность между которыми следует вычислить.
| FirstDayOfWeek | Необязательный. Константа, указывающая первый день недели. Если этот аргумент опущен, считается, что неделя начинается с воскресенья.
| FirstWeekOfYear | Необязательный. Константа, указывающая первую неделю года. Если этот аргумент опущен, первой неделей считается неделя, содержащая 1 января. |
| Замечания
| Аргумет firstdayofweek может
принимает следующие значения: |
| Константа |
Значение |
Описание |
| vbUseSystem |
0 |
Use the NLS API setting. |
| vbSunday |
1 |
Воскресенье (по умолчанию) |
| vbMonday |
2 |
Понедельник |
| vbTuesday |
3 |
Вторник |
| vbWednesday |
4 |
Среда |
| vbThursday |
5 |
Четверг |
| vbFriday |
6 |
Пятница |
| vbSaturday |
7 |
Суббота |
| Аргумет firstweekofyear может
принимает следующие значения: |
| Константа |
Значение |
Описание |
| vbUseSystem |
0 |
Use the NLS API setting. |
| vbFirstJan1 |
1 |
Начинать с недели: 1 января (по
умолчанию). |
| vbFirstFourDays |
2 |
Начинать с первой недели,
которая имеет хотя бы один день нового
года. |
| vbFirstFullWeek |
3 |
Начинать с полной первой
недели нового года. |
| Пример использования 'в данном примере функция DateDiff используется для определения
'числа дней между указанной и текущей датой
Dim TheDate As Date 'объявляет переменные
Dim Msg
TheDate = InputBox("Введите дату:")
Msg = "Разность (дней): " & DateDiff("д", Now, TheDate)
MsgBox Msg | Дополнительная информация Категория: Обработка данных дата/время Еще функции: Date, DateAdd, DateDiff, DatePart, DateSerial, DateValue, Day, Hour, Minute, Month, MonthName, Now, Second, Time, Timer, TimeSerial, TimeValue, WeekDay, WeekDayName, Year |
|
|
| |
|
|
|
|
Справочник по Visual Basic