Share via

datetime_add()

  • Статья

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

Синтаксис

datetime_add(Период,Сумма,Datetime)

Дополнительные сведения о соглашениях о синтаксисе.

Параметры

Имя Тип Обязательно Описание
Период string ✔️ Продолжительность времени, к которой необходимо приращение.
Сумма int ✔️ Число периодов, которые необходимо добавить к datetime или вычесть из даты и времени.
datetime datetime ✔️ Дата, приращение к результату вычисления периода x.

Возможные значения точки:

  • Year
  • Quarter
  • Месяц
  • Неделя
  • День
  • Hour
  • Минута
  • Second
  • Миллисекунда
  • Микросекунда
  • Наносекунда

Возвращаемое значение

Дата и время после добавления определенного интервала времени или даты.

Примеры

Период

Выполнить запрос

print  year = datetime_add('year',1,make_datetime(2017,1,1)),
quarter = datetime_add('quarter',1,make_datetime(2017,1,1)),
month = datetime_add('month',1,make_datetime(2017,1,1)),
week = datetime_add('week',1,make_datetime(2017,1,1)),
day = datetime_add('day',1,make_datetime(2017,1,1)),
hour = datetime_add('hour',1,make_datetime(2017,1,1)),
minute = datetime_add('minute',1,make_datetime(2017,1,1)),
second = datetime_add('second',1,make_datetime(2017,1,1))

Выходные данные

year квартал month week day hour minute second
2018-01-01 00:00:00.0000000 2017-04-01 00:00:00.0000000 2017-02-01 00:00:00.0000000 2017-01-08 00:00:00.0000000 2017-01-02 00:00:00.0000000 2017-01-01 01:00:00.0000000 2017-01-01 00:01:00.0000000 2017-01-01 00:00:01.0000000

Сумма

Выполнить запрос

print  year = datetime_add('year',-5,make_datetime(2017,1,1)),
quarter = datetime_add('quarter',12,make_datetime(2017,1,1)),
month = datetime_add('month',-15,make_datetime(2017,1,1)),
week = datetime_add('week',100,make_datetime(2017,1,1))

Выходные данные

year квартал month week
2012-01-01T00:00:00Z 2020-01-01T00:00:00Z 2015-10-01T00:00:00Z 2018-12-02T00:00:00Z