datetime_diff()
Область применения: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Вычисляет количество указанных периодов между двумя значениями даты и времени .
Синтаксис
datetime_diff(
datetime1,
,
datetime2)
Дополнительные сведения о соглашениях синтаксиса.
Параметры
Имя (название) | Type | Обязательно | Описание |
---|---|---|---|
период | string |
✔️ | Измерение времени, используемого для вычисления возвращаемого значения. См . возможные значения. |
datetime1 | datetime |
✔️ | Левая сторона уравнения вычитания. |
datetime2 | datetime |
✔️ | Справа от уравнения вычитания. |
Возможные значения периода
Эти значения являются нечувствительными к регистру:
- Год
- Квартал
- Месяц
- Неделя
- День
- Часы
- Minute
- Second
- Миллисекунда
- мс
- Наносекунда
Возвраты
Целое число, представляющее количество периодов в результате вычитания (datetime1 - datetime2).
Пример
print
year = datetime_diff('year',datetime(2017-01-01),datetime(2000-12-31)),
quarter = datetime_diff('quarter',datetime(2017-07-01),datetime(2017-03-30)),
month = datetime_diff('month',datetime(2017-01-01),datetime(2015-12-30)),
week = datetime_diff('week',datetime(2017-10-29 00:00),datetime(2017-09-30 23:59)),
day = datetime_diff('day',datetime(2017-10-29 00:00),datetime(2017-09-30 23:59)),
hour = datetime_diff('hour',datetime(2017-10-31 01:00),datetime(2017-10-30 23:59)),
minute = datetime_diff('minute',datetime(2017-10-30 23:05:01),datetime(2017-10-30 23:00:59)),
second = datetime_diff('second',datetime(2017-10-30 23:00:10.100),datetime(2017-10-30 23:00:00.900)),
millisecond = datetime_diff('millisecond',datetime(2017-10-30 23:00:00.200100),datetime(2017-10-30 23:00:00.100900)),
microsecond = datetime_diff('microsecond',datetime(2017-10-30 23:00:00.1009001),datetime(2017-10-30 23:00:00.1008009)),
nanosecond = datetime_diff('nanosecond',datetime(2017-10-30 23:00:00.0000000),datetime(2017-10-30 23:00:00.0000007))
Выходные данные
год | quarter | Месяц | нед. | дн. | ч | мин | секунда | millisecond | microsecond | nanosecond |
---|---|---|---|---|---|---|---|---|---|---|
17 | 2 | 13 | 5 | 29 | 2 | 5 | 10 | 100 | 100 | -700 |