Поделиться через


datetime_add()

Область применения: ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

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

Синтаксис

datetime_add(время даты и времени периода,,)

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

Параметры

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

Возможные значения периода:

  • Год
  • Квартал
  • Месяц
  • Неделя
  • День
  • Часы
  • Minute
  • 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))

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

год quarter Месяц нед. дн. ч мин секунда
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))

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

год quarter Месяц нед.
2012-01-01T00:00:00Z 2020-01-01T00:00:00Z 2015-10-01T00:00:00Z 2018-12-02T00:00:00Z