On This Page

Home / Search/ Language Reference/ Functions/ Scalar Functions/ DateTime Functions/datetime_diff

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
​

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