TIMESTAMPDIFF

功能描述

TIMESTAMPDIFF(unit,datetime expr1,datetime expr2)函数返回两个日期参数expr2 - expr1的值，这两个参数都有可能是datetime或者是date，如果参数是date，则认为时间部分为0。计算差值之后，将计算结果转换成指定单位显示。

unit有以下值：MICROSECOND , SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, QUARTER, 或者是 YEAR。当输入参数不合法时，此函数返回NULL。

注意事项

该功能仅在数据库兼容模式为MySQL时支持（即数据库实例初始化时指定DBCOMPATIBILITY='B'）。

语法格式

TIMESTAMPDIFF(unit,datetime expr1,datetime expr2)

参数说明

• expr1,expr2

  输入的日期值。

• unit

  单位。

  取值范围：MICROSECOND , SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, QUARTER, 或者是 YEAR。

  当输入参数不合法时，此函数返回NULL。

示例

SELECT timestampdiff(SECOND,'2001-01-01 12:12:12','2001-01-01 12:12:11');
SELECT timestampdiff(MONTH,'2001-01-01 12:12:12','2001-02-01 12:12:12');

返回结果分别为：

 timestampdiff
---------------
            -1
(1 row)

 timestampdiff
---------------
             1
(1 row)