datetime_diff()

Artigo
08/12/2024

Applies to: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

Calculates the number of the specified periods between two datetime values.

Syntax

datetime_diff(period,datetime1,datetime2)

Parameters

Name	Type	Required	Description
period	`string`	✔️	The measurement of time used to calculate the return value. See possible values.
datetime1	`datetime`	✔️	The left-hand side of the subtraction equation.
datetime2	`datetime`	✔️	The right-hand side of the subtraction equation.

Possible values of period

These values are case insensitive:

Year
Quarter
Month
Week
Day
Hour
Minute
Second
Millisecond
Microsecond
Nanosecond

Returns

An integer that represents the amount of periods in the result of subtraction (datetime1 - datetime2).

Example

Run the query

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

Output

year	quarter	month	week	day	hour	minute	second	millisecond	microsecond	nanosecond
17	2	13	5	29	2	5	10	100	100	-700

Compartilhar via