TIMESTAMPDIFF

功能描述

计算两个日期或日期时间值之间的差异，并返回指定时间单位的差值。

说明：

与MySQL差异：TIMESTAMPDIFF()函数使用注意事项：当第三个参数为DATE类型时，第一个参数仅支持年、季度、月份、周、日；若第一个参数为时、分、秒、微秒，则函数返回NULL，此时需要将第三个参数由DATE类型转换为DATETIME类型。

语法格式

TIMESTAMPDIFF(expr1,expr2,expr3)

参数说明

• expr1：SECOND、MINUTE、HOUR、DAY、WEEK、MONTH、QUARTER或YEAR。
• expr2：时间（DATE/DATETIME/DATETIME WITH TIME ZONE）。
• expr3：时间（DATE/DATETIME/DATETIME WITH TIME ZONE）。

函数返回类型

BIGINT类型。

示例

SQL> SELECT TIMESTAMPDIFF(DAY,'2003-01-10','2003-01-02');

EXPR1 | 
------------------------------------------------------------------------------
-8 |

SQL> SELECT TIMESTAMPDIFF(YEAR,'2010-01-01','2003-01-02');

EXPR1 | 
------------------------------------------------------------------------------
-6 |

SQL> SELECT TIMESTAMPDIFF(YEAR,'2010-01-01','2012-01-02');

EXPR1 | 
------------------------------------------------------------------------------
2 |