dateadd()

Назначение

Функция dateadd() инкрементирует/декрементирует дату на указанное число число лет/месяцев/дней/часов/минут/секунд.

Синтаксис и аргументы
Значения типа Дата/время необходимо заключать в знак решетки (например: #2001-01-01#).

dateadd(дата/время, число инкремента или декремента даты, компонент даты)

Функция требует наличия трех аргументов:

  • первый аргумент – данные типа Дата/время;

  • второй аргумент – число, на которое увеличивается компонент даты, указанный в третьем аргументе (если это число отрицательное, то компонент даты, указанный в третьем аргументе, уменьшается);

  • третий аргумент – строка, показывающая компонент даты, который нужно изменить.

Для третьего аргумента используются следующие параметры:

  • "Y" – годы;

  • "M" – месяцы;

  • "D" – дни;

  • "h" – часы;

  • "m" – минуты;

  • "s" – секунды.

Год принимается равным 365 дням, месяц – 30 дням.
Возвращаемое значение

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

Примеры

dateadd(#2023-03-01#, -1, "M") возвращает 01.02.2023 (3-ий месяц, март, уменьшается до 2 месяца, февраля)

dateadd(#2024-02-29#, -1, "Y") возвращает 28.02.2023 (год уменьшен на 1, с 2024 до 2023)

dateadd(#2001-01-24 02:15:02#, 1, "D") возвращает 25.01.2001 2:15:02 (день увеличивается до следующего дня)

dateadd(#2001-01-24 02:15:02#, 2, "h") возвращает 24.01.2001 4:15:02 (часы увеличиваются на 2 часа)

dateadd(#2001-01-24 02:15:02#, 20, "m") возвращает 24.01.2001 2:35:02 (минуты увеличиваются на 20 минут)