更新时间:2026-10-21 GMT+08:00
分享

日期和时间函数

以下为GaussDB数据库M-Compatibility兼容性日期时间函数公共差异说明。

  • 当SELECT子查询中包含且仅包含时间函数,且函数入参包含表中的列时,使用算数运算符(如+、-、*、/、取反等)对结果进行运算时,会截断日期与时间函数返回值后再进行算数运算。
    m_db=# CREATE TABLE t1(int_var int);
    CREATE TABLE
    m_db=# INSERT INTO t1 VALUES(100);
    INSERT 0 1
    m_db=# SELECT (SELECT (1 * DATE_ADD('2020-10-20', interval int_var microsecond))) AS a FROM t1; -- 不进行截断处理。
           a        
    ----------------
     20201020000000
    (1 row)
    
    m_db=# SELECT (1 * (SELECT DATE_ADD('2020-10-20', interval int_var microsecond))) AS a FROM t1; -- 进行截断处理。
      a   
    ------
     2020
    (1 row)
    
    m_db=# SELECT 1 * a FROM (SELECT (SELECT 1 * DATE_ADD('2020-10-20', interval int_var microsecond)) AS a FROM t1) AS t2; -- 不进行截断处理。
         1 * a      
    ----------------
     20201020000000
    (1 row)
    
    m_db=# SELECT 1 * a FROM (SELECT (SELECT DATE_ADD('2020-10-20', interval int_var microsecond)) AS a FROM t1) AS t2; -- 进行截断处理。
     1 * a 
    -------
      2020
    (1 row)
表1 日期和时间函数列表

函数名

与MySQL的差异

ADDDATE()

-

ADDTIME()

-

CONVERT_TZ()

  • MySQL支持使用'system'指定时区为系统时区,GaussDB不支持使用'system'指定时区。
  • CONVERT_TZ执行转换前,会校验时间是否合法且在TIMESTAMP类型范围内('1970-01-01 00:00:01' UTC ~ '2038-01-19 03:14:07' UTC),时间合法但不在范围内则不转换,返回原值。MySQL校验第一个入参经第二个入参(from_tz)转换为UTC后的值是否满足要求,GaussDB则仅校验第一个入参的原始值。
    -- GaussDB
    m_db=# SELECT convert_tz('1970-01-01 00:00:01', '-01:00', '+01:00'), convert_tz('1970-01-01 00:00:01', '+01:00', '+03:00');
         convert_tz      |     convert_tz      
    ---------------------+---------------------
     1970-01-01 02:00:01 | 1970-01-01 02:00:01
    (1 row)
    
    m_db=#  SELECT convert_tz('1970-01-01 00:00:00', '-01:00', '+01:00'), convert_tz('1970-01-01 00:00:00', '+01:00', '+03:00');
         convert_tz      |     convert_tz      
    ---------------------+---------------------
     1970-01-01 00:00:00 | 1970-01-01 00:00:00
    (1 row)
    
    -- MySQL
    mysql> SELECT convert_tz('1970-01-01 00:00:01', '-01:00', '+01:00'), convert_tz('1970-01-01 00:00:01', '+01:00', '+03:00');
    +-------------------------------------------------------+-------------------------------------------------------+
    | convert_tz('1970-01-01 00:00:01', '-01:00', '+01:00') | convert_tz('1970-01-01 00:00:01', '+01:00', '+03:00') |
    +-------------------------------------------------------+-------------------------------------------------------+
    | 1970-01-01 02:00:01                                   | 1970-01-01 00:00:01                                   |
    +-------------------------------------------------------+-------------------------------------------------------+
    1 row in set (0.00 sec)
    
    mysql>  SELECT convert_tz('1970-01-01 00:00:00', '-01:00', '+01:00'), convert_tz('1970-01-01 00:00:00', '+01:00', '+03:00');
    +-------------------------------------------------------+-------------------------------------------------------+
    | convert_tz('1970-01-01 00:00:00', '-01:00', '+01:00') | convert_tz('1970-01-01 00:00:00', '+01:00', '+03:00') |
    +-------------------------------------------------------+-------------------------------------------------------+
    | 1970-01-01 02:00:00                                   | 1970-01-01 00:00:00                                   |
    +-------------------------------------------------------+-------------------------------------------------------+
    1 row in set (0.00 sec)

CURDATE()

-

CURRENT_DATE()/CURRENT_DATE

-

CURRENT_TIME()/CURRENT_TIME

MySQL入参整型值会按照一字节最大值255整数回绕(例:SELECT CURRENT_TIME(257) == SELECT CURRENT_TIME(1))。

GaussDB只支持[0,6]合法值,其他值报错。

CURRENT_TIMESTAMP()/CURRENT_TIMESTAMP

CURTIME()

LOCALTIME()/LOCALTIME

LOCALTIMESTAMP/LOCALTIMESTAMP()

NOW()

SYSDATE()

UTC_TIME()

UTC_TIMESTAMP()

DATE()

-

DATE_ADD()

-

DATE_FORMAT()

-

DATE_SUB()

-

DATEDIFF()

-

DAY()

-

DAYNAME()

-

DAYOFMONTH()

-

DAYOFWEEK()

-

DAYOFYEAR()

-

EXTRACT()

  • 当EXTRACT(unit FROM date)中unit入参的取值为DAY_HOUR、DAY_MINUTE、DAY_SECOND或DAY_MICROSECOND时GaussDB会将date入参按datetime类型的格式要求进行解析,MySQL会将date入参按time类型的格式要求进行解析。
    -- GaussDB
    m_db=# SELECT EXTRACT(DAY_HOUR FROM '10:30:45') AS res;
    WARNING:  Incorrect datetime value: '10:30:45'
    CONTEXT:  referenced column: res
     res 
    -----
    
    (1 row)
    
    -- MySQL
    mysql> SELECT EXTRACT(DAY_HOUR FROM '10:30:45') AS res;
    +------+
    | res  |
    +------+
    |   10 |
    +------+
    1 row in set (0.00 sec)
  • 当EXTRACT(unit FROM date)中date入参的类型为datetime类型并且unit入参的取值为DAY_HOUR、DAY_MINUTE、DAY_SECOND或DAY_MICROSECOND时,GaussDB的结果都会返回DAY的部分,MySQL的结果只有在date入参为表数据时会返回DAY的部分,例如:
    -- GaussDB的行为:
    m_db=# DROP TABLE IF EXISTS t_datetime;
    DROP TABLE
    
    m_db=# CREATE TABLE t_datetime(c1 datetime(6));
    CREATE TABLE
    
    m_db=# INSERT INTO t_datetime VALUES('2023-01-27 10:11:12.400000');
    INSERT 0 1
    
    -- date入参为表数据时,结果会返回DAY的部分。
    m_db=# SELECT EXTRACT(DAY_MICROSECOND FROM c1) FROM t_datetime;
        extract     
    ----------------
     27101112400000
    (1 row)
    
    -- date入参为常量数据时,结果也会返回DAY的部分。
    m_db=# SELECT EXTRACT(DAY_MICROSECOND FROM cast('2023-01-27 10:11:12.400000' as datetime(6)));
        extract     
    ----------------
     27101112400000
    (1 row)
    
    m_db=# DROP TABLE IF EXISTS t_datetime;
    DROP TABLE
    
    -- MySQL的行为:
    mysql> DROP TABLE IF EXISTS t_datetime;
    Query OK, 0 rows affected (0.04 sec)
    
    mysql> CREATE TABLE t_datetime(c1 datetime(6));
    Query OK, 0 rows affected (0.05 sec)
    
    mysql> INSERT INTO t_datetime VALUES('2023-01-27 10:11:12.400000');
    Query OK, 1 row affected (0.00 sec)
    
    -- date入参为表数据时,结果会返回DAY的部分。
    mysql> SELECT EXTRACT(DAY_MICROSECOND FROM c1) FROM t_datetime;
    +----------------------------------+
    | EXTRACT(DAY_MICROSECOND FROM c1) |
    +----------------------------------+
    |                   27101112400000 |
    +----------------------------------+
    1 row in set (0.01 sec)
    
    -- date入参为常量数据时,结果不会返回DAY的部分。
    mysql> SELECT EXTRACT(DAY_MICROSECOND FROM cast('2023-01-27 10:11:12.400000' as datetime(6)));
    +---------------------------------------------------------------------------------+
    | EXTRACT(DAY_MICROSECOND FROM cast('2023-01-27 10:11:12.400000' as datetime(6))) |
    +---------------------------------------------------------------------------------+
    |                                                                    101112400000 |
    +---------------------------------------------------------------------------------+
    1 row in set (0.00 sec)
    
    mysql> DROP TABLE IF EXISTS t_datetime;
    Query OK, 0 rows affected (0.04 sec)

FROM_DAYS()

-

FROM_UNIXTIME()

-

GET_FORMAT()

-

HOUR()

-

LAST_DAY()

-

MAKEDATE()

-

MAKETIME()

-

MICROSECOND()

-

MINUTE()

-

MONTH()

-

MONTHNAME()

-

PERIOD_ADD()

MySQL 8.0修复了以下问题,在以下场景中,该函数的行为与MySQL 8.0版本保持一致,与MySQL 5.7版本存在差异:

  • 整数溢出处理的行为:

    MySQL在5.7版本,此函数入参和结果的最大值都为2^32=4294967296,在入参或结果的period对应的月份累加值以及month_number超过uint32范围时存在整数回绕问题。GaussDB不存在该问题。

  • 负数period的表现:

    MySQL在5.7版本,会将负数年份解析为异常值而不是报错。GaussDB入参或结果(如100年1月减去10000月)出现负数时报错。

  • period月份越界的表现:

    MySQL在5.7版本中,若月份大于12或等于0,例如200013、199900,会将其顺延到之后的年份,或者将0月作为上一年12月处理。GaussDB会对越界月份进行报错。

  • 入参无法严格转换为整数时的行为:

    MySQL在5.7版本中,当传入的参数无法严格转换为整数时,会将其强制转换为整数值,GaussDB进行报错。

    -- GaussDB
    m_db=# SELECT period_add('20.1', 1);
    WARNING:  The INTEGER value '20.1' is incorrect.
    CONTEXT:  referenced column: period_add
    ERROR:  Incorrect arguments to period_add
    CONTEXT:  referenced column: period_add
    m_db=# SELECT period_add('20ab', 1);
    WARNING:  The INTEGER value '20ab' is incorrect.
    CONTEXT:  referenced column: period_add
    ERROR:  Incorrect arguments to period_add
    CONTEXT:  referenced column: period_add
    
    -- MySQL
    mysql> SELECT period_add('20.1', 1);
    +-----------------------+
    | period_add('20.1', 1) |
    +-----------------------+
    |                200109 |
    +-----------------------+
    1 row in set, 1 warning (0.00 sec)
    
    Warning (Code 1292): Truncated incorrect INTEGER value: '20.1'
    mysql> SELECT period_add('20ab', 1);
    +-----------------------+
    | period_add('20ab', 1) |
    +-----------------------+
    |                200109 |
    +-----------------------+
    1 row in set, 1 warning (0.00 sec)
    
    Warning (Code 1292): Truncated incorrect INTEGER value: '20ab'

PERIOD_DIFF()

-

QUARTER()

-

SEC_TO_TIME()

-

SECOND()

-

STR_TO_DATE()

-

SUBDATE()

-

SUBTIME()

-

TIME()

-

TIME_FORMAT()

-

TIME_TO_SEC()

-

TIMEDIFF()

-

TIMESTAMP()

-

TIMESTAMPADD()

-

TIMESTAMPDIFF()

-

TO_DAYS()

-

TO_SECONDS()

在MySQL 5.7版本中,此函数的精度信息有误。

开启精度传递参数下,GaussDB精度信息正常,和MySQL 8.0版本保持一致。

UNIX_TIMESTAMP()

MySQL会根据入参是否存在小数位,决定返回定点型还是整型。当前GaussDB在内层嵌套操作符或函数时,返回的类型与MySQL可能存在不同。当内层节点返回定点、浮点、字符型、时间类型(不包括DATE类型)时,MySQL可能返回整型,GaussDB会返回定点型。

UTC_DATE()

-

WEEK()

-

WEEKDAY()

-

WEEKOFYEAR()

-

YEAR()

-

YEARWEEK()

-

相关文档