Дата/Время функции

AddDay

AddDay(Дата, Количество)

  • Дата - аргумент типа Дата/Время
  • Количество - аргумент целого типа.

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

AddMonth

AddMonth(Дата, Количество)

  • Дата - аргумент типа Дата/Время
  • Количество - аргумент целого типа.

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

Если указанный день месяца больше, чем последний день получившегося месяца, то функция устанавливает дату на последний день получившегося месяца.

AddQuarter

AddQuarter(Дата, Количество)

  • Дата - аргумент типа Дата/Время
  • Количество - аргумент целого типа.

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

Если указанный день месяца больше, чем последний день месяца получившегося квартала , то функция устанавливает дату на последний день месяца получившегося квартала.

AddWeek

AddWeek(Дата, Количество)

  • Дата - аргумент типа Дата/Время
  • Количество - аргумент целого типа.

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

AddYear

AddYear(Дата, Количество)

  • Дата - аргумент типа Дата/Время
  • Количество - аргумент целого типа.

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

DateTimeToStr

DateTimeToStr(Дата_время [, Формат_даты [, Формат_времени]])

  • Дата_время - выражение типа дата/время.
  • Формат_даты - необязательный параметр формат даты в терминах D, M, Y.
  • Формат_времени - необязательный параметр формат времени в терминах H, N, S, Z.

Возвращает строковое представление аргумента Дата_время. Примеры формата даты: "DD.MM.YY" - преобразует дату в формат "день.месяц.год" ("25.12.04") "MM/DD/YYYY" - преобразует дату в формат "месяц.день.год" ("12/25/2004") Примеры формата времени: "H:NN" - преобразует время в формат "часы:минуты" ("9:53") "HH:NN:SS" - преобразует время в формат "часы:минуты:секунды" ("09:05:53")

DateToStr

DateToStr(Дата [, Формат_даты])

  • Дата - выражение типа дата/время.
  • Формат_даты - необязательный параметр формат даты в терминах D, M, Y.

Возвращает строковое представление аргумента Дата. Примеры формата даты: "DD.MM.YY" - преобразует дату в формат "день.месяц.год" ("25.12.04") "MM/DD/YYYY" - преобразует дату в формат "месяц.день.год" ("12/25/2004")

Day

Day(Дата)

  • Дата - поле типа дата.

Возвращает день по заданной дате.

DayOfWeek

DayOfWeek(Дата)

  • Дата - поле типа дата.

Возвращает день недели заданной даты.

DaysBetween

DaysBetween(Дата1, Дата2)

  • Дата1, Дата2 - поля типа дата.

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

EncodeDate

EncodeDate(Год, Месяц, День)

  • Год - год в виде числа,
  • Месяц - месяц в виде числа,
  • День - день в виде числа.

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

EncodeDateTime

EncodeDateTime(Год, Месяц, День, Часы, Минуты, Секунды)

  • Год - год в виде числа,
  • Месяц - месяц в виде числа,
  • День - день в виде числа,
  • Часы - часы в виде числа,
  • Минуты - минуты в виде числа,
  • Секунды - секунды в виде числа.

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

EncodeTime

EncodeTime(Часы, Минуты, Секунды)

  • Часы - часы в виде числа,
  • Минуты - минуты в виде числа,
  • Секунды - секунды в виде числа.

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

Hour

Hour(ДатаВремя)

  • ДатаВремя - поле типа дата/время.

Возвращает час по заданной дате/времени.

ISO8601ToDate

ISO8601ToDate(Аргумент)

  • Аргумент - строковое выражение, содержащее дату/время в формате ISO 8601

Функция конвертирует строку, содержащую дату/время в формате ISO 8601, в значение типа "Дата/Время". Если в аргументе указано смещение времени относительно UTC, то дата/время приводится к текущей временной зоне. Иначе дата/время остаётся без изменений.

Minute

Minute(ДатаВремя)

  • ДатаВремя - поле типа дата/время.

Возвращает минуты по заданной дате/времени.

Month

Month(Дата)

  • Дата - поле типа дата.

Возвращает месяц по заданной дате.

MonthsBetween

MonthsBetween(Дата1, Дата2)

  • Дата1, Дата2 - поля типа дата.

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

Now

Now()

  • Аргументы отсутствуют.

Возвращает текущую дату и время. Так как текущая дата и время - это время вычисления выражения, которое считается каждый раз при получении значения этого выражения, например, при просмотре результата в виде таблицы или при выполнении экспорта данных, то можно, при наличии параметра выражения "Кэшировать рассчитанные значения выражения" включить эту опцию.

Second

Second(ДатаВремя)

  • ДатаВремя - поле типа дата/время.

Возвращает секунды по заданной дате/времени.

StartOfTheWeek

StartOfTheWeek(Дата)

  • Дата - аргумент типа Дата/Время.

Функция возвращает дату начала указанной недели в соответствии со стандартом ISO 8601, по которому неделя начинается с понедельника и заканчивается воскресеньем.

StrToDate

StrToDate(Аргумент [, Формат])

  • Аргумент - строковое выражение, содержащее дату/время
  • Формат - необязательный параметр формат даты/время в терминах D, M, Y, H, N, S, Z

Функция конвертирует строку, содержащую дату в формат типа "Дата/Время". Примеры формата: "DD.MM.YY" - говорит, что Аргумент содержит строки вида "25.12.04"; "DD/MM/YY/HH:NN:SS" - говорит, что Аргумент содержит строки вида "25/12/04/12:44:54";

Today

Today()

  • Аргументы отсутствуют.

Возвращает текущую дату. Так как текущая дата - это дата вычисления выражения, которое считается каждый раз при получении значения этого выражения, например, при просмотре результата в виде таблицы или при выполнении экспорта данных, то можно, при наличии параметра выражения "Кэшировать рассчитанные значения выражения" включить эту опцию.

Week

Week(Дата)

  • Дата - поле типа дата.

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

Year

Year(Дата)

  • Дата - поле типа дата.

Возвращает год по заданной дате.

YearsBetween

YearsBetween(Дата1, Дата2)

  • Дата1, Дата2 - поля типа дата.

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