更新时间:2024-05-31 GMT+08:00

日期与时间数据类型

表1 日期与时间数据类型

序号

MySQL数据库

GaussDB数据库

差异

1

DATE

支持

GaussDB支持date数据类型,与MySQL相比规格上存在如下差异:

  • 输入格式
    • GaussDB只支持字符类型,不支持数值类型。如支持'2020-01-01'或'20200101'字符串格式,不支持20200101数值输入。MySQL支持数值输入转换为date类型。
    • 分隔符:GaussDB不支持加号“+”、冒号“:”作为年、月、日之间的分隔符,其他的符号都支持。MySQL所有符号均可作为分隔符。 分隔符混合使用的某些场景也不支持,与MySQL也有差异,如'2020-01>01','2020/01+01'等,不建议混合使用分隔符,建议使用最常用的“-”、“/”作为分隔符。
    • 无分隔符:推荐使用完整格式,如 'YYYYMMDD' 或者 'YYMMDD'。其他不完整的格式(包括超长格式)解析的规则与MySQL存在差异,可能报错或者解析的结果与MySQL不一致,不推荐使用。
  • 输出格式

    GaussDB在sql_mode参数不包含'strict_trans_tables'选项(定义为宽松模式,否则为严格模式)时,允许年、月、日的值是0,但是输出时会按照年、月、日的顺序依次转换为合法的值,如date '0000-00-10' 转换为:0002-12-10 BC。 非法输入或者超过范围时,会报warning信息,并返回0000-00-00值。MySQL对于包含0值年、月、日的date值会原样输出。

  • 取值范围

    GaussDB的范围是4713-01-01 BC ~ 5874897-12-31 AD,支持公元前的日期,宽松模式下超过范围时,返回的是0值:0000-00-00,严格模式下会报错。MySQL的范围是 0000-00-00 ~ 9999-12-31,宽松模式下超过范围后,各个场景下的表现并不一致,可能报错(如select查询语句中),也可能返回0000-00-00值(如insert时)。此差异会导致date类型作为函数入参时,函数返回的结果存在差异。

  • 操作符
    • GaussDB仅支持date类型之间的比较操作符“=”、“!=”、“<”、“<=”、“>”、“>=”,返回true或者false;date与interval类型的加法运算,返回结果为date类型;date与interval类型的减法运算,返回结果为date类型;date类型之间的减法运算,返回结果为interval类型。
    • MySQL date类型和其他数值类型运算时,会先将date转换为数值类型,然后按照数值类型运算,结果也为数值类型。与GaussDB存在差异。如:
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    -- MySQL: date + 数值,先将date类型转换为数值20200101,再与1相加,结果为数值类型20200102
    mysql> select date'2020-01-01' + 1;
    +----------------------+
    | date'2020-01-01' + 1 |
    +----------------------+
    |             20200102 |
    +----------------------+
    1 row in set (0.00 sec)
    
    -- GaussDB: date + 数值,数值类型会转换为interval类型 1 day,然后相加得到新的日期。
    gaussdb=# select date'2020-01-01' + 1;
      ?column?  
    ------------
     2020-01-02
    (1 row)
    
  • 类型转换

    相比较MySQL,GaussDB仅支持date类型与char(n)、nchar(n)、datetime、timestamp类型之间的相互转换,不支持与binary、decimal、json、integer、unsigned integer、time 类型之间的转换。集合等场景和复杂表达式场景下公共类型的确定原则与MySQL也不一致,参考数据类型转换章节的描述。

2

DATETIME[(fsp)]

支持

GaussDB支持datetime数据类型,与MySQL相比规格上存在如下差异:

  • 输入格式:
    • GaussDB只支持字符类型,不支持数值类型。如支持'2020-01-01 10:20:30.123456'或'20200101102030.123456'字符串格式,不支持如20200101102030.123456的数值类型输入。MySQL支持数值输入转换为datetime类型。
    • 分隔符:GaussDB不支持加号“+”、冒号“:”作为年、月、日之间的分隔符,其他的符号都支持。仅支持冒号“:”作为时、分、秒之间的分隔符,其他的符号都不支持。分隔符混合使用的某些场景也不支持,与MySQL也有差异,不推荐使用。MySQL支持所有符号作为分隔符。
    • 无分隔符:GaussDB推荐使用完整格式'YYYYMMDDhhmiss.ffffff'。其他不完整的格式(包括超长格式)解析的规则可能与MySQL存在差异,可能报错或者解析的结果与MySQL不一致,不推荐使用。
  • 输出格式:
    • 统一为'YYYY-MM-DD hh:mi:ss.ffffff'的格式,格式与MySQL无差异,且不受DateStyle参数的影响。但是对于精度部分,如果最后几位为0,GaussDB不显示,MySQL会显示。
    • GaussDB在sql_mode参数不包含'strict_trans_tables'选项(定义为宽松模式,否则为严格模式)时,允许年、月、日值是0,但是输出时会按照年、月、日的顺序依次转换为合法的值,如datetime '0000-00-10 00:00:00' 转换为:0002-12-10 00:00:00 BC。 非法输入或者超过范围时,会报warning信息,并返回0000-00-00 00:00:00值。MySQL对于包含0值年、月、日的datetime值会原样输出。
  • 取值范围

    4713-11-24 00:00:00.000000 BC ~ 294277-01-09 04:00:54.775806 AD。294277-01-09 04:00:54.775807 AD 返回的是infinity。对于超过范围的值,严格模式下GaussDB会报错,MySQL是否报错取决于使用场景。一般查询场景不报错,而执行DML SQL语句更改表属性的值时报错。宽松模式下GaussDB返回0000-00-00 00:00:00值,MySQL根据使用场景可能报错,也可能返回0000-00-00 00:00:00值或者null值。这个差异会导致以datetime类型为入参的函数执行结果与MySQL也存在差异。

  • 精度

    范围0~6,作为表列的类型时缺省为0,与MySQL一致。对于 datetime[(p)] 'str' 表达式场景,GaussDB将(p)作为精度解析,缺省为6,将'str'按照p指定的精度格式化成datetime类型。MySQL不支持datetime[(p)] 'str'表达式。

  • 操作符
    • GaussDB仅支持datetime类型之间的比较操作符“=”、“!=”、“<”、“<=”、“>”、“>=”,返回true或者false;datetime与interval类型的加法运算,返回结果为datetime类型;datetime与interval 类型的减法运算,返回结果为datetime类型;datetime类型之间的减法运算,返回结果为interval类型。
    • MySQL datetime类型和其他数值类型运算时,会先将datetime转换为数值类型,然后按照数值类型运算,结果也为数值类型。与GaussDB存在差异。如:
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    -- MySQL: datetime + 数值,先将datetime类型转换为数值20201010123456,再与1相加,结果为数值类型20201010123457
    mysql> select cast('2020-10-10 12:34:56.123456' as datetime) + 1;
    +----------------------------------------------------+
    | cast('2020-10-10 12:34:56.123456' as datetime) + 1 |
    +----------------------------------------------------+
    |                                     20201010123457 |
    +----------------------------------------------------+
    1 row in set (0.00 sec)
    
    -- GaussDB: datetime + 数值,数值类型会转换为interval类型 1 day,然后相加得到新的datetime。
    gaussdb=# select cast('2020-10-10 12:34:56.123456' as datetime) + 1;
          ?column?       
    ---------------------
     2020-10-11 12:34:56
    (1 row)
    

    将datetime类型与数值的运算结果作为函数的入参,可能导致函数的结果与MySQL也存在差异。

  • 类型转换

    相比较MySQL,GaussDB仅支持datetime类型与char(n)、nchar(n)、timestamp类型之间的相互转换、datetime到date、time类型的转换(仅赋值和显式转换)。不支持与binary、decimal、json、integer、unsigned integer类型之间的转换。集合等场景和复杂表达式场景下公共类型的确定原则与MySQL也不一致,参考数据类型转换章节的描述。

  • 时区

    GaussDB支持datetime值中携带时区信息(时区偏移或者时区名),如'2020-01-01 12:34:56.123456 +01:00' 或者 '2020-01-01 2:34:56.123456 CST'。GaussDB会将其转换为当前服务器时区的时间。MySQL不支持(5.7版本不支持,8.0及之后的版本支持)。

  • GaussDB的datetime数据类型的表字段实际上会被转换为timestamp(p) without time zone类型,查询表信息或者使用工具导出的表结构,其字段的数据类型显示的是timestamp(p) without time zone,而不是datetime。MySQL显示的是datetime(p)。

3

TIMESTAMP[(fsp)]

支持

GaussDB支持timestamp数据类型,与MySQL相比规格上存在如下差异:

  • 输入格式
    • 只支持字符类型,不支持数值类型。如支持'2020-01-01 10:20:30.123456'或'20200101102030.123456'字符串格式,不支持如20200101102030.123456的数值类型输入。MySQL支持数值输入转换为timestamp类型。
    • 分隔符:不支持加号“+”、冒号“:”作为年、月、日之间的分隔符,其他的符号都支持。仅支持冒号“:”作为时、分、秒之间的分隔符,其他的符号都不支持。分隔符混合使用的某些场景也不支持,与MySQL也有差异,不推荐使用。MySQL支持所有符号作为分隔符。
    • 无分隔符:推荐使用完整格式'YYYYMMDDhhmiss.ffffff'。其他不完整的格式(包括超长格式)解析的规则可能与MySQL存在差异,可能报错或者解析的结果与MySQL不一致,不推荐使用。
  • 输出格式
    • 统一为'YYYY-MM-DD hh:mi:ss.ffffff'的格式,格式与MySQL无差异,且不受DateStyle参数的影响。但是对于精度部分,如果最后几位为0,GaussDB不显示,MySQL会显示。
    • GaussDB在sql_mode参数不包含'strict_trans_tables'选项(定义为宽松模式,否则为严格模式)时,允许年、月、日值是0,但是输出时会按照年、月、日的顺序依次转换为合法的值,如timestamp '0000-00-10 00:00:00' 转换为:0002-12-10 00:00:00 BC。 非法输入或者超过范围时,会报warning信息,并返回0000-00-00 00:00:00值。MySQL对于包含0值年、月、日的timestamp值会原样输出。
  • 取值范围

    4713-11-24 00:00:00.000000 BC ~ 294277-01-09 04:00:54.775806 AD。294277-01-09 04:00:54.775807 AD 返回的是infinity。对于超过范围的值,严格模式下GaussDB会报错,MySQL是否报错取决于使用场景。一般查询场景不报错,而执行DML SQL语句更改表属性的值时报错。宽松模式下GaussDB返回0000-00-00 00:00:00值,MySQL根据使用场景可能报错,也可能返回0000-00-00 00:00:00值或者null值。这个差异会导致以timestamp类型为入参的函数执行结果与MySQL也存在差异。

  • 精度
    范围0~6,作为表列的类型时缺省为0,与MySQL一致。对于 timestamp[(p)] 'str' 表达式场景:
    • GaussDB将(p)作为精度解析,缺省为6,将'str'按照p指定的精度格式化成timestamp类型。
    • MySQL将timestamp 'str'的含义与GaussDB一致,缺省精度也为6。但是将timestamp(p) 'str'解析为函数调用,p作为timestamp函数的入参,结果返回一个timestamp类型的值,'str'作为投影列的别名。
  • 操作符
    • GaussDB仅支持timestamp类型之间的比较操作符“=”、“!=”、“<”、“<=”、“>”、“>=”,返回true或者false;timestamp与interval类型的加法运算,返回结果为timestamp类型;timestamp与interval类型的减法运算,返回结果为timestamp类型;timestamp类型之间的减法运算,返回结果为interval类型。
    • MySQL timestamp类型和其他数值类型运算时,会先将timestamp转换为数值类型,然后按照数值类型运算,结果也为数值类型。与GaussDB存在差异。如:
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    -- MySQL: timestamp + 数值,先将timestamp类型转换为数值20201010123456.123456,再与1相加,结果为数值类型20201010123457.123456
    mysql> select timestamp '2020-10-10 12:34:56.123456' + 1;
    +--------------------------------------------+
    | timestamp '2020-10-10 12:34:56.123456' + 1 |
    +--------------------------------------------+
    |                      20201010123457.123456 |
    +--------------------------------------------+
    1 row in set (0.00 sec)
    
    -- GaussDB: timestamp + 数值,数值类型会转换为interval类型 1 day,然后相加得到新的timestamp。
    gaussdb=# select timestamp '2020-10-10 12:34:56.123456' + 1;
              ?column?          
    ----------------------------
     2020-10-11 12:34:56.123456
    (1 row)
    

    将timestamp类型与数值的运算结果作为函数的入参,可能导致函数的结果与MySQL也存在差异。

  • 类型转换

    相比较MySQL,GaussDB仅支持timestamp类型与char(n)、varchar(n)、datetime类型之间的相互转换、timestamp到date、time类型的转换(仅赋值和显式转换)。不支持与binary、decimal、json、integer、unsigned integer类型之间的转换。集合等场景和复杂表达式场景下公共类型的确定原则与MySQL也不一致,参考数据类型转换章节的描述。

  • 时区

    GaussDB支持timestamp值中携带时区信息(时区偏移或者时区名),如'2020-01-01 12:34:56.123456 +01:00' 或者 '2020-01-01 2:34:56.123456 CST'。GaussDB会将其转换为当前服务器时区的时间。如果更改服务器时区,timestamp类型的值输出时会转换为更改后时区的时间戳。MySQL不支持(5.7版本不支持,8.0及之后的版本支持)。

  • GaussDB的timestamp数据类型的表字段实际上会被转换为timestamp(p) with time zone类型,查询表信息或者使用工具导出的表结构,其字段的数据类型显示的是timestamp(p) with time zone,而不是timestamp。MySQL显示的是timestamp(p)。

4

TIME[(fsp)]

支持

GaussDB支持time数据类型,与MySQL相比规格上存在如下差异:

  • 输入格式
    • 只支持字符类型,不支持数值类型。如支持'1 10:20:30'或'102030'字符串格式,不支持102030数值输入。MySQL支持数值输入转换为time类型。
    • 分隔符:GaussDB仅支持冒号“:”作为时、分、秒之间的分隔符,其他的符号都不支持。MySQL支持所有的符号作为分隔符。
    • 无分隔符:推荐使用完整格式,如 'hhmiss.ffffff'。其他不完整的格式(包括超长格式)解析的规则可能与MySQL存在差异,可能报错或者解析的结果与MySQL不一致,不推荐使用。
    • 分、秒、精度输入负数时,GaussDB数据库可能会忽略第一个负数开始的部分,涉及的部分解析为0,如:'00:00:-10' 解析结果为 '00:00:00'。 也可能报错,如:'00:00:-10000' 会解析报错。取决于输入值的范围。而MySQL数据库统一报错。
  • 输出格式

    统一为hh:mi:ss.ffffff的格式,格式与MySQL无差异。但是对于精度部分,如果最后几位为0,GaussDB不显示,MySQL会显示。

  • 取值范围

    -838:59:59.000000 ~ 838:59:59.000000,与MySQL一致。对于超过范围的值,宽松模式下GaussDB无论是查询还是insert/update等DML操作,返回的值都是就近的边界值:-838:59:59或838:59:59。MySQL是查询时报错,DML操作返回的值才是就近边界值,场景上存在差异。此差异会导致time类型作为函数入参时,函数返回的结果也存在差异。

  • 精度

    范围0~6,作为表列的类型时缺省为0,与MySQL一致。对于 time(p) 'str' 表达式场景,GaussDB将(p)作为精度解析,缺省为6,将'str'按照p指定的精度格式化成time类型。MySQL是解析为time函数,p是入参,'str'是投影列的别名。

  • 操作符
    • GaussDB仅支持time类型之间的比较操作符“=”、“!=”、“<”、“<=”、“>”、“>=”,返回true或者false;time与interval类型的加法运算,返回结果为time类型;time与interval类型的减法运算,返回结果为time类型;time类型之间的减法运算,返回结果为interval类型。
    • MySQL time类型和其他数值类型运算时,会先将time转换为数值类型,然后按照数值类型运算,结果也为数值类型。与GaussDB存在差异。如:
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    -- MySQL: time + 数值,先将time类型转换为数值123456,再与1相加,结果为数值类型123457
    mysql> select time '12:34:56' + 1;
    +---------------------+
    | time '12:34:56' + 1 |
    +---------------------+
    |              123457 |
    +---------------------+
    1 row in set (0.00 sec)
    
    -- GaussDB: time + 数值,数值类型会转换为interval类型 1 day,然后相加得到新的time,由于是加了24小时,得到的仍然是12:34:56。
    gaussdb=# select time '12:34:56' + 1;
     ?column? 
    ----------
     12:34:56
    (1 row)
    

    将time类型与数值的运算结果作为函数的入参,可能导致函数的结果与MySQL也存在差异。

  • 类型转换

    相比较MySQL,GaussDB仅支持time类型与char(n)、nchar(n)类型之间的相互转换、datetime、timestamp到time类型的转换。不支持与binary、decimal、date、json、integer、unsigned integer类型之间的转换。集合等场景和复杂表达式场景下公共类型的确定原则与MySQL也不一致,参考数据类型转换章节的描述。

5

YEAR[(4)]

支持

GaussDB支持year数据类型,与MySQL相比规格上存在如下差异:

  • 操作符
    • GaussDB仅支持year类型之间的比较操作符“=”、“!=”、“<”、“<=”、“>”、“>=”,返回true或者false。
    • GaussDB仅支持year类型与int4类型之间的算术操作符“+”、“-”,返回整型值,MySQL是返回无符号整型值。
  • 类型转换

    相比较MySQL,GaussDB仅支持year类型与int4类型的转换,仅支持int4、varchar、numeric、date、time、timestamp、timestamptz类型到year类型的转换。集合等场景和复杂表达式场景下公共类型的确定原则与MySQL也不一致,参考数据类型转换章节的描述。

6

INTERVAL

支持

GaussDB支持INTERVAL数据类型,但INTERVAL在MySQL中为表达式,同时存在以下差异:

  • 不支持字符串类型的日期输入作为运算,如:select '2023-01-01' + interval 1 day。
  • 不支持interval expr unit语法中,expr为负整数或浮点数的输入,如:select date'2023-01-01' + interval -1 day。
  • 不支持interval expr unit语法中,expr为运算表达式的输入,如:select date'2023-01-01' + interval 4/2 day。
  • interval表达式参与运算时,返回值固定为datetime类型,MySQL为datetime或date类型。运算的逻辑与原有GaussDB保持一致,与MySQL有差异。
  • interval expr unit语法中,expr数值支持的范围会根据unit单位的不同有所差异,最大可支持的范围为[-2147483648, 2147483647]。超过范围时,严格模式报error,宽松模式报warning并返回0值。
  • interval expr unit语法中,expr指定的字段数量大于unit预期的字段数量时,在严格模式,报error;在宽松模式,报warning并返回0值。如unit取值为DAY_HOUR,预期的字段数量为2,expr取值为'1-2-3',字段数量为3。