Функции даты и времени

Функции даты и времени возвращают данные, связанные с датой и временем. Обратите внимание, что может потребоваться преобразование формата источника данных в приложении.

Таблица 1: Функции даты и времени

Функция

Синтаксис

Описание

AddMonthToDate(#date#,periods)

  • #date#: исходная дата
  • periods: добавляемое число периодов

Возвращает значение даты, полученное путем добавления к исходной дате указанного числа месяцев.

Например:
AddMonthToDate(#2012-01-01#,1)
возвращает 2012-02-01

AddWeekToDate(#date#,periods)

  • #date#: исходная дата
  • periods: добавляемое число периодов

Возвращает значение даты, полученное путем добавления к исходной дате указанного числа недель.

Например:
AddWeekToDate(#2012-01-01#,1)
возвращает 2012-01-08

AddYearToDate(#date#,periods)

  • #date#: исходная дата
  • periods: добавляемое число периодов

Возвращает значение даты, полученное путем добавления к исходной дате указанного числа лет. Чтобы вычитания лет используйте отрицательные значения.

Например:
AddYearToDate(#2012-01-01#,1)
возвращает 2013-01-01

CurrentDate()

Возврат текущей даты в виде даты.

Например:
CurrentDate()
Возвращает значение <CurrentDate>

DateDiffInDays(#start#,#end#)

  • #start#: начальная дата в интервале
  • #end#: конечная дата в интервале

Возвращает количество дней между двумя датами.

Например:
DateDiffInDays(#2012-03-23#,#2012-01-30#)
возвращает -53

DateDiffInMonths(#start#,#end#)

  • #start#: начальная дата в интервале
  • #end#: конечная дата в интервале

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

Например:
DateDiffInMonths(#2013-02-01#,#2014-01-01#)
возвращает 11

Day(#date#)

#date#: дата

Возвращает день месяца в виде числа от 1 до 31.

Например:
Day(#2012-03-23#)
возвращает 23

DayOfWeek(#date#)

#date#: дата

Возвращает день недели в виде числа от 1 (воскресенье) до 7 (суббота).

Например:
DayOfWeek(#2012-03-23#)
возвращает 6

DayOfYear(#date#)

#date#: дата

Возвращает день года в виде числа.

Например:
DayOfYear(#2012-03-23#)
возвращает 83

LastDayOfMonth(#date#)

#date#: дата

Возвращает дату, полученную путем вычисления последнего дня месяца, на который приходится данная дата.

Например:
LastDayOfMonth(#2012-03-23#)
возвращает дату 2012-03-31

LastDayOfWeek(#date#)

#date#: дата

Возвращает дату, полученную путем вычисления последнего дня месяца, на который приходится данная дата.

Например:
LastDayOfWeek(#2012-03-23#)
возвращает дату 2012-03-24

MakeDate(year,month,day)

  • year: число, соответствующее году
  • month: число, соответствующее месяцу
  • day: число, соответствующее дню месяца

Возвращает дату, состоящую из указанных года, месяца и дня.

Например:
MakeDate(2011,6,12)
возвращает дату 2011-06-12

Month(#date#)

#date#: дата

Возвращает месяц года в виде числа от 1 до 12.

Например:
Month(#2012-03-23#)
возвращает 3

Quarter(#date#)

#date#: дата

Возвращает число, обозначающее квартал, на который приходится указанная дата.

Например:
Quarter(#2012-03-23#)
возвращает 1

Week(#date#)

#date#: дата

Возвращает число, обозначающее квартал, на который приходится указанная дата.

Например:
Week(#2012-03-23#)
возвращает 12

Year(#date#)

#date#: дата

Возвращает год, на который приходится указанная дата.

Например:
Year(#2012-03-23#)
возвращает 2012