datetime_diff
The datetime_diff
function calculates the number of the specified periods between two datetime values.
Syntax
datetime_diff( Period, Datetime1, Datetime2 )
Arguments
- Period: Possible values are:
Year
,Quarter
,Month
,Week
,Day
,Hour
,Minute
,Second
,Millisecond
,Microsecond
,Nanosecond
. - DatetimeX: A datetime.
Returns
An integer, which represents amount of Periods in the result of subtraction (Datetime1 - Datetime2)
.
Examples
The following examples illustrate calling this function with different values for the Period
argument:
printyear = datetime_diff('year',datetime(2017-01-01),datetime(2000-12-31))
printquarter = datetime_diff('quarter',datetime(2017-07-01),datetime(2017-03-30))
printmonth = datetime_diff('month',datetime(2017-01-01),datetime(2015-12-30))
printweek = datetime_diff('week',datetime(2017-10-29 00:00),datetime(2017-09-30 23:59))
printday = datetime_diff('day',datetime(2017-10-29 00:00),datetime(2017-09-30 23:59))
printhour = datetime_diff('hour',datetime(2017-10-31 01:00),datetime(2017-10-30 23:59))
printminute = datetime_diff('minute',datetime(2017-10-30 23:05:01),datetime(2017-10-30 23:00:59))
printsecond = datetime_diff('second',datetime(2017-10-30 23:00:10.100),datetime(2017-10-30 23:00:00.900))
printmillisecond = datetime_diff('millisecond',datetime(2017-10-30 23:00:00.200100),datetime(2017-10-30 23:00:00.100900))
printmicrosecond = datetime_diff('microsecond',datetime(2017-10-30 23:00:00.1009001),datetime(2017-10-30 23:00:00.1008009))
printnanosecond = datetime_diff('nanosecond',datetime(2017-10-30 23:00:00.0000000),datetime(2017-10-30 23:00:00.0000007))