VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

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)