datetime_diff() (разница_даты_времени)

Переключайте службы с помощью раскрывающегося списка Версия. Дополнительные сведения о навигации.
Область применения: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

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

Синтаксис

datetime_diff( datetime1,,datetime2)

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

Параметры

Имя (название)	Тип	Обязательно	Описание
период	string	✔️	Измерение времени, используемого для вычисления возвращаемого значения. См . возможные значения.
datetime1	datetime	✔️	Левая сторона уравнения вычитания.
datetime2	datetime	✔️	Справа от уравнения вычитания.

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

Эти значения являются нечувствительными к регистру:

• Год
• Квартал
• Месяц
• Неделя
• День
• Часы
• Минута
• Второй
• Миллисекунда
• мс
• Наносекунда

Возвраты

Возвращает целое число, представляющее количество периодов в результате вычитания (datetime1 - datetime2).

Примеры

В следующем примере показано, как вычислить период между двумя значениями даты и времени с datetime_diff помощью функции.

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

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))

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

год	четверть	Месяц	нед.	дн.	ч	мин	секунда	миллисекунда	микросекунда	наносекунда
17	2	13 (тринадцать)	5	29	2	5	10	100	100	-700