Visual Basic, .NET, ASP, VBA, VBScript
 
  Справочники  
  Справочник по Windows API Справочник по Visual Basic  
     
  Функция 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 января.

Замечания

Функция использует именованные аргументы.
Параметр interval может принамать одно их следующих значений: yyyy -Год, q - Квартал, m - Месяц, y - День года, d - День месяца, w - День недели, ww - Неделя, h - Часы, n - Минуты, s - Секунды.

Аргумет 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

 
     
  VBNet online (всего: 51200)  
 

Логин:

Пароль:

Регистрация, забыли пароль?


В чате сейчас человек
 
     
  VBNet рекомендует  
   
     
  Лучшие материалы  
 
ActiveX контролы (112)
Hitman74_Library (36119)
WindowsXPControls (20739)
FlexGridPlus (19374)
DSMAniGifControl (18295)
FreeButton (15157)
Примеры кода (546)
Parol (18027)
Passworder (9299)
Screen saver (7654)
Kerish AI (5817)
Folder_L (5768)
Статьи по VB (136)
Мое второе впечатление... (11236)
VB .NET: дорога в будущее (11161)
Основы SQL (9225)
Сообщения Windows в Vi... (8788)
Классовая теория прогр... (8619)
 
     
Техническая поддержка MTW-хостинг | © Copyright 2002-2011 VBNet.RU | Пишите нам