Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Переключайте службы с помощью раскрывающегося списка Версия. Дополнительные сведения о навигации.
Область применения: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel
Вычисляет новое время даты из указанного периода, умноженного на указанную сумму, добавленную или вычитаемую из указанного даты.
Синтаксис
datetime_add(
время даты и времени периода,,)
Дополнительные сведения о соглашениях синтаксиса.
Параметры
| Имя (название) | Тип | Обязательно | Описание |
|---|---|---|---|
| период | string |
✔️ | Период времени, на который необходимо увеличить. |
| количество | int |
✔️ | Количество периодов, в которые нужно добавить или вычитать из даты и времени. |
| datetime | datetime |
✔️ | Дата увеличения по результату вычисления суммы x периода. |
Возможные значения периода:
- Год
- Квартал
- Месяц
- Неделя
- День
- Часы
- Минута
- Второй
- Миллисекунда
- мс
- Наносекунда
Возвраты
Возвращает дату после добавления определенного интервала времени и даты.
Примеры
В следующем примере показано, как добавить период к значению даты и времени с функцией datetime_add .
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))
Выходные данные
| год | четверть | Месяц | нед. | дн. | ч | мин | секунда |
|---|---|---|---|---|---|---|---|
| 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 |
В следующем примере показано, как использовать datetime_add функцию для добавления или вычитания интервалов времени с определенной даты.
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))
Выходные данные
| год | четверть | Месяц | нед. |
|---|---|---|---|
| 2012-01-01T00:00:00Z | 2020-01-01T00:00:00Z | 2015-10-01T00:00:00Z | 2018-12-02T00:00:00Z |