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

AddDay

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

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

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

AddHour

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

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

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

AddMillisecond

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

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

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

AddMinute

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

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

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

AddMonth

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

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

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

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

AddQuarter

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

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

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

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

AddSecond

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

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

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

AddWeek

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

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

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

AddYear

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

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

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

DateTimeToStr

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

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

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

DateToStr

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

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

Возвращает строковое представление аргумента Дата.

Day

Day(Дата)

• Дата — поле типа Дата/Время.

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

DayOfWeek

DayOfWeek(Дата)

• Дата — поле типа Дата/Время.

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

DaysBetween

DaysBetween(Дата1, Дата2[, Абсолютное_Значение=True])

• Дата1, Дата2 — поля типа Дата/Время.
• Абсолютное_Значение — необязательный параметр логического типа, по умолчанию True.

Возвращает полное количество дней между двумя датами. Если Абсолютное_Значение = False и Дата1 > Дата2, то будет возвращено отрицательное значение функции. Если Абсолютное_Значение=True, а Дата1 > Дата2, то функция вернет модуль значения. Дата1 и Дата2 должны быть кратны 1 миллисекунде.

EncodeDate

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

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

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

EncodeDateTime

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

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

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

EncodeTime

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

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

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

EndOfTheMonth

EndOfTheMonth(Дата)

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

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

EndOfTheQuarter

EndOfTheQuarter(Дата)

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

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

EndOfTheWeek

EndOfTheWeek(Дата)

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

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

EndOfTheYear

EndOfTheYear(Дата)

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

Функция возвращает дату и время окончания года, указанного в Дата.

Hour

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

• ДатаВремя — поле типа Дата/Время.

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

HoursBetween

HoursBetween(Дата1, Дата2[, Абсолютное_Значение=True])

• Дата1, Дата2 — поля типа Дата/Время.
• Абсолютное_Значение — необязательный параметр логического типа, по умолчанию True.

Возвращает полное количество часов между двумя датами. Если Абсолютное_Значение = False и Дата1 > Дата2, то будет возвращено отрицательное значение функции. Если Абсолютное_Значение=True, а Дата1 > Дата2, то функция вернет модуль значения. Дата1 и Дата2 должны быть кратны 1 миллисекунде.

ISO8601ToDate

ISO8601ToDate(Аргумент)

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

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

MillisecondsBetween

MillisecondsBetween(Дата1, Дата2[, Абсолютное_Значение=True])

• Дата1, Дата2 — поля типа Дата/Время.
• Абсолютное_Значение — необязательный параметр логического типа, по умолчанию True.

Возвращает полное количество миллисекунд между двумя датами. Если Абсолютное_Значение = False и Дата1 > Дата2, то будет возвращено отрицательное значение функции. Если Абсолютное_Значение=True, а Дата1 > Дата2, то функция вернет модуль значения. Дата1 и Дата2 должны быть кратны 1 миллисекунде.

Minute

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

• ДатаВремя — поле типа Дата/Время.

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

MinutesBetween

MinutesBetween(Дата1, Дата2[, Абсолютное_Значение=True])

• Дата1, Дата2 — поля типа Дата/Время.
• Абсолютное_Значение — необязательный параметр логического типа, по умолчанию True.

Возвращает полное количество минут между двумя датами. Если Абсолютное_Значение = False и Дата1 > Дата2, то будет возвращено отрицательное значение функции. Если Абсолютное_Значение=True, а Дата1 > Дата2, то функция вернет модуль значения. Дата1 и Дата2 должны быть кратны 1 миллисекунде.

Month

Month(Дата)

• Дата — поле типа Дата/Время.

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

MonthsBetween

MonthsBetween(Дата1, Дата2[, Абсолютное_Значение=True])

• Дата1, Дата2 — поля типа Дата/Время.
• Абсолютное_Значение — необязательный параметр логического типа, по умолчанию True.

Возвращает полное количество месяцев между двумя датами. Если Абсолютное_Значение = False и Дата1 > Дата2, то будет возвращено отрицательное значение функции. Если Абсолютное_Значение=True, а Дата1 > Дата2, то функция вернет модуль значения. Дата1 и Дата2 должны быть кратны 1 миллисекунде.

Now

Now()

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

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

Second

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

• ДатаВремя — поле типа Дата/Время.

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

SecondsBetween

SecondsBetween(Дата1, Дата2[, Абсолютное_Значение=True])

• Дата1, Дата2 — поля типа Дата/Время.
• Абсолютное_Значение — необязательный параметр логического типа, по умолчанию True.

Возвращает полное количество секунд между двумя датами. Если Абсолютное_Значение = False и Дата1 > Дата2, то будет возвращено отрицательное значение функции. Если Абсолютное_Значение=True, а Дата1 > Дата2, то функция вернет модуль значения. Дата1 и Дата2 должны быть кратны 1 миллисекунде.

StartOfInterval

StartOfInterval(Дата, Количество_Интервалов, Тип_Интервала[, Начальная_Точка])

• Дата — аргумент типа Дата/Время.
• Количество_Интервалов — количество интервалов заданного типа, целое число.
• Тип_Интервала — тип временного интервала.
• Начальная_Точка — необязательный параметр типа дата/время от которого начинают отсчитываться временные интервалы.

Функция рассчитывает начало произвольного временного интервала.

Тип_Интервала может принимать следующие значения:

• "Year" — интервал задан в годах (начало отсчёта по умолчанию — первый год).
• "Quarter" — интервал задан в кварталах (начало отсчёта по умолчанию — первый квартал первого года).
• "Month" — интервал задан в месяцах (начало отсчёта по умолчанию — январь первого года).
• "Week" — интервал задан в неделях (начало отсчёта по умолчанию — 1 января 1900 года).
• "Day" — интервал задан в днях (начало отсчёта по умолчанию — 30 декабря 1899 года).
• "Hour" — интервал задан в часах (начало отсчёта по умолчанию — 30 декабря 1899 года).
• "Minute" — интервал задан в минутах (начало отсчёта по умолчанию — полночь 30 декабря 1899 года).
• "Second" — интервал задан в секундах (начало отсчёта по умолчанию — полночь 30 декабря 1899 года).

Важно Для Тип_Интервала "Year", "Quarter", "Month" расчет идет от 01.01.0001 года Н.Э.

Если Начальная_Точка не совпадает с началом интервала выбранноего типа, то производится корректировка расчетов.

Пример: если Тип_Интервала — "Month", а Начальная_Точка = 15 ноября 2023 года, то интервалы будут расчитаны относительно 1 ноября 2023 года.

StartOfTheMonth

StartOfTheMonth(Дата)

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

Функция возвращает дату начала месяца, указанного в Дата.

StartOfTheQuarter

StartOfTheQuarter(Дата)

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

Функция возвращает дату начала квартала, указанного в Дата.

StartOfTheWeek

StartOfTheWeek(Дата)

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

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

StartOfTheYear

StartOfTheYear(Дата)

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

Функция возвращает дату начала года, указанного в Дата.

StrToDate

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

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

Функция конвертирует строку, содержащую дату в формат типа Дата/Время.

%/spoiler%Примеры формата:%/spoiler%

"DD.MM.YY" — говорит, что Аргумент содержит строки вида "25.12.04";

"DD/MM/YY/HH:NN:SS" — говорит, что Аргумент содержит строки вида "25/12/04/12:44:54".

%/spoiler%

Today

Today()

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

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

UnixToDateTime

UnixToDateTime(Дата[, Исходная_Дата_в_UTC=True])

• Дата — исходная дата в формате Unix Time, целое число.
• Исходная_Дата_в_UTC — необязательный аргумент логического типа, по умолчанию True.

Функция конвертирует время из Unix Time в формат Дата/Время.

Если Исходная_Дата_в_UTC=False — то результат вызова функции будет приведен к местному времени.

Week

Week(Дата)

• Дата — поле типа Дата/Время.

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

Year

Year(Дата)

• Дата — поле типа Дата/Время.

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

YearsBetween

YearsBetween(Дата1, Дата2[, Абсолютное_Значение=True])

• Дата1, Дата2 — поля типа Дата/Время.
• Абсолютное_Значение — необязательный параметр логического типа.

Возвращает полное количество лет между двумя датами. Если Абсолютное_Значение = False и Дата1 > Дата2, то будет возвращено отрицательное значение функции. Если Абсолютное_Значение=True, а Дата1 > Дата2, то функция вернет модуль значения. Дата1 и Дата2 должны быть кратны 1 миллисекунде.