时间和日期处理函数和操作符

时间/日期函数

相比于原始的openGauss,dolphin对于时间/日期函数的修改主要为:

  1. 新增dayofmonth/dayofweek/dayofyear/hour/microsecond/minute/quarter/second/weekday/weekofyear/year/current_date函数。
  2. 新增curdate/current_time/curtime/current_timestamp/localtime/localtimestamp/now/sysdate函数。
  3. 新增makedate/maketime/period_add/period_diff/sec_to_time/subdate函数。
  4. 新增subtime/timediff/time/time_format/timestamp/timestamppadd函数。
  5. 新增to_days/to_seconds/unix_timestamp/utc_date/utc_time/utc_timestamp函数。
  6. 新增date_bool/time_bool函数。
  7. 新增dayname/monthname/time_to_sec/month/day/date/week/yearweek函数,修改了last_day函数。
  8. 新增datediff/from_days/convert_tz/date_add/date_sub/adddate/addtime函数,修改了timestampdiff函数。
  • curdate()

    描述:返回语句开始执行的日期。

    返回值类型:date

    示例:

    openGauss=# select curdate();
    curdate
    ------------
    2022-07-21
    (1 row)
    
  • current_time

    描述:返回语句开始执行的时间。

    返回值类型:time

    示例:

    openGauss=# select current_time;
    current_time
    --------------
    16:56:02
    (1 row)
    
  • current_time(n)

    描述:返回语句开始执行的时间,n为精度,最大值取6。

    返回值类型:time

    示例:

    openGauss=# select current_time(3);
     current_time(3)
    -----------------
    16:57:23.255
    (1 row)
    
    openGauss=# select current_time();
     current_time()
    ----------------
    17:05:01
    (1 row)
    
  • curtime(n)

    描述:返回语句开始执行的时间,n为精度,最大值取6。

    返回值类型:time

    示例:

    openGauss=# select curtime(3);
    curtime(3)
    --------------
    17:45:33.844
    (1 row)
    
    openGauss=# select curtime();
    curtime()
    -----------
    17:45:54
    (1 row)
    
  • current_timestamp

    描述:返回语句开始执行的时间戳。

    返回值类型:datetime

    示例:

    openGauss=# select current_timestamp;
      current_timestamp
    ---------------------
    2022-07-21 16:59:38
    (1 row)
    
  • current_timestamp(n)

    描述:返回语句开始执行的时间戳,n为精度,最大值取6。

    返回值类型:datetime

    示例:

    openGauss=# select current_timestamp(3);
      current_timestamp(3)
    -------------------------
    2022-07-21 17:00:41.251
    (1 row)
    
    openGauss=# select current_timestamp();
     current_timestamp()
    ---------------------
    2022-07-21 17:06:06
    (1 row)
    
  • dayofmonth(timestamp)

    描述:获取日期/时间值中天数的值。

    返回值类型:double precision

    示例:

    openGauss=# SELECT dayofmonth(timestamp '2001-02-16 20:38:40');
     date_part
    -----------
            16
    (1 row)
    
  • dayofweek(timestamp)

    描述:获取日期/时间值中星期的标号(1代表星期日,2代表星期一,以此类推,7代表星期六)。

    返回值类型:double precision

    示例:

    openGauss=# SELECT dayofweek(timestamp '2001-02-16 20:38:40');
     ?column?
    ----------
            6
    (1 row)
    
  • dayofyear(timestamp)

    描述:获取日期/时间值中一年的第几天。

    返回值类型:double precision

    示例:

    openGauss=# SELECT dayofyear(timestamp '2001-02-16 20:38:40');
     date_part
    -----------
            47
    (1 row)
    
  • hour(timestamp)

    描述:获取日期/时间值中小时的值。

    返回值类型:double precision

    示例:

    openGauss=# SELECT hour(timestamp '2001-02-16 20:38:40');
     date_part
    -----------
            20
    (1 row)
    
  • localtime

    描述:返回语句开始执行的时间戳。

    返回值类型:datetime

    示例:

    openGauss=# select localtime;
        localtime
    ---------------------
    2022-07-21 17:02:04
    (1 row)
    
  • localtime(n)

    描述:返回语句开始执行的时间戳,n为精度,最大值取6。

    返回值类型:datetime

    示例:

    openGauss=# select localtime(3);
        localtime
    ---------------------
    2022-07-21 17:02:04
    (1 row)
    
    openGauss=# select localtime();
        localtime()
    ---------------------
    2022-07-21 17:14:22
    (1 row)
    
  • localtimestamp

    描述:返回语句开始执行的时间戳。

    返回值类型:datetime

    示例:

    openGauss=# select localtimestamp;
    localtimestamp
    ---------------------
    2022-07-21 17:17:20
    (1 row)
    
  • localtimestamp(n)

    描述:返回语句开始执行的时间戳,n为精度,最大值取6。

    返回值类型:datetime

    示例:

    openGauss=# select localtimestamp(3);
        localtimestamp(3)
    -------------------------
    2022-07-21 17:28:02.013
    (1 row)
    
    openGauss=# select localtimestamp();
    localtimestamp()
    ---------------------
    2022-07-21 17:28:49
    (1 row)
    
  • MAKEDATE()

    函数原型:

    DATE MAKEDATE(int64 year, int64 dayofyear) 功能描述:

    给定年份和天数,返回该年份在此年份天数下日期值。

    备注:

    • 任一为NULL,函数返回NULL。
    • dayofyear必须大于0否则返回NULL。
    • 0 <= year < 70时:将year视作20XX年处理。 70 <= year < 100时:将year视作19XX年处理。
    • 返回结果限制在[0, 9999-12-31],超出范围返回NULL。

    示例:

 openGauss=# SELECT MAKEDATE(2022,31), MAKEDATE(2022,32);
   makedate  |  makedate  
------------+------------
 2022-01-31 | 2022-02-01
(1 row)

-- 0<= year < 70 以及 70 <= year < 100
 openGauss=# SELECT MAKEDATE(0,31), MAKEDATE(70,32);
  makedate  |  makedate  
------------+------------
 2000-01-31 | 1970-02-01
(1 row)

-- dayofyear <= 0 以及 超出范围 的情况
 openGauss=# SELECT MAKEDATE(2022,0), MAKEDATE(9999,366);
  makedate | makedate 
----------+----------
          | 
(1 row)
  • MAKETIME()

    函数原型:

    TIME MAKETIME(int64 hour, int64 minue, Numeric second)

    功能描述:

    给定小时、分钟和秒参数,返回TIME类型值。

    备注:

    • 当参数满足如下任一条件时,函数返回NULL:
      1. minue < 0 or minue >= 60
      2. second < 0 or second >= 60
      3. 任一参数为NULL
    • 返回的Time结果保留6位小数,若second超出六位小数,则按照四舍五入进位。
    • 返回TIME类型值要求在[-838:59:59, 838:59:59]中。若超出范围,则根据hour的正负类型,来返回指定的边界值。

    示例:

 openGauss=# SELECT MAKETIME(15, 15, 15.5);
  maketime  
------------
 15:15:15.5
(1 row)

-- 四舍五入进位
 openGauss=# SELECT MAKETIME(10, 15, 20.5000005);
    maketime     
-----------------
 10:15:20.500001
(1 row)

-- 四舍五入进位
 openGauss=# SELECT MAKETIME(839,0,0);
 maketime  
-----------
 838:59:59
(1 row)
  • microsecond(timestamp)

    描述:获取日期/时间值中微秒的值。

    返回值类型:double precision

    示例:

    openGauss=# SELECT microsecond(timestamp '2001-02-16 20:38:40.123');
     date_part
    -----------
        123000
    (1 row)
    
  • minute(timestamp)

    描述:获取日期/时间值中分钟的值。

    返回值类型:double precision

    示例:

    openGauss=# SELECT minute(timestamp '2001-02-16 20:38:40.123');
     date_part
    -----------
            38
    (1 row)
    
  • now(n)

    描述:返回语句开始执行的时间戳,n为精度,最大值取6。

    返回值类型:datetime

    示例:

    openGauss=# select now(3);
            now(3)
    -------------------------
    2022-07-21 17:30:18.037
    (1 row)
    
    openGauss=# select now();
            now()
    ---------------------
    2022-07-21 17:30:51
    (1 row)
    
  • PERIOD_ADD()

    函数原型:

    int64 PERIOD_ADD(int64 P, int64 N)

    功能描述:

    返回时期P(格式为YYYYMM或YYMM)加上N个月后的时期值,格式为YYYYMM。

    备注:

    • 当任一参数为NULL时,函数返回NULL。
    • P = 0时,返回0。
    • 参数的时期P与返回结果的时期中的年份小于100时,会以70为边界,将年份转为20XX年或19XX年。

    示例:

 openGauss=# SELECT PERIOD_ADD(202201, 2);
  period_add 
------------
     202203
(1 row)
 
 -- p = 0
 openGauss=# SELECT PERIOD_ADD(0, 2);
 period_add 
------------
          0
(1 row)

 -- 时期的年份处于[0,70) 或 [70, 100)范围内
 openGauss=# SELECT PERIOD_ADD(0101, 2), PERIOD_ADD(7001, 2);
 period_add | period_add 
------------+------------
     200103 |     197003
(1 row)
  • PERIOD_DIFF()

    函数原型:

    int64 PERIOD_DIFF(int64 P1, int64 P2)

    功能描述:

    返回两个时期参数P1P2的月份数差值。

    备注:

    • 当任一参数为NULL时,函数返回NULL。
    • 时期参数P1P2中的年份小于100时,会以70为边界,将年份转为20XX年或19XX年。

    示例:

 openGauss=# SELECT PERIOD_DIFF(202201,202003);
  period_diff 
-------------
          22
(1 row)

 openGauss=# SELECT PERIOD_DIFF(0101,7001);
 period_diff 
-------------
         372
(1 row)
  • quarter(timestamp)

    描述:获取日期/时间值中的季度数,从1到4。

    返回值类型:double precision

    示例:

    openGauss=# SELECT quarter(timestamp '2001-02-16 20:38:40.123');
     date_part
    -----------
            1
    (1 row)
    
  • second(timestamp)

    描述:获取日期/时间值中的秒数。

    返回值类型:double precision

    示例:

    openGauss=# SELECT second(timestamp '2001-02-16 20:38:40.123');
     date_part
    -----------
           40
    (1 row)
    
  • SEC_TO_TIME()

    函数原型:

    TIME SEC_TO_TIME(Numeric second)

    功能描述:

    给定秒数,将其转为小时、分钟与秒,返回TIME类型值。

    备注:

    • 当任一参数为NULL,函数返回NULL。
    • 返回TIME类型值只保留小数点后6位,超出部分按照四舍五入规则进位。
    • 返回TIME类型值要求在[-838:59:59, 838:59:59]中。若超出范围,则根据second的正负类型,来返回指定的边界值。

    示例:

 openGauss=# SELECT SEC_TO_TIME(4396);
 sec_to_time 
-------------
 01:13:16
(1 row)

-- 四舍五入进位
 openGauss=# SELECT SEC_TO_TIME(2378.2222225);
   sec_to_time   
-----------------
 00:39:38.222223
(1 row)

-- 返回结果超出范围
 openGauss=# SELECT SEC_TO_TIME(3888888);
 sec_to_time 
-------------
 838:59:59
(1 row)
  • SUBDATE(expr, interval)

    函数原型:

    CString SUBDATE(text date, INTERVAL expr unit)

    CString SUBDATE(text date, int64 days)

    功能描述:

    该函数执行日期运算。参数date指定开始DATE或DATETIME类型值。指定要从开始日期减去的INTERVAL值,返回相减后的结果日期值。若第二参数为整数,则将其视为减去的天数值。

    备注:

    • 函数返回格式为DATE或DATETIME。一般情况下,返回类型与第一参数的类型相同。当第一参数的类型为DATE时且INTERVAL的单位包含HOUR、MINUTE、SECOND部分,则返回结果为DATETIME。

    • 参数满足如下任一条件时,函数返回NULL:

      1. 参数date的日期超出范围[0, 9999-12-31]
      2. 任一参数为NULL。
    • 返回结果的日期必须在范围[0001-1-1, 9999-12-31]内。若越界,则返回NULL。

    示例:

 openGauss=# SELECT SUBDATE('2022-01-01', INTERVAL 31 DAY), SUBDATE('2022-01-01', 31);
  subdate   |  subdate   
------------+------------
 2021-12-01 | 2021-12-01
(1 row)

-- 第一参数为DATE
 openGauss=# SELECT SUBDATE('2022-01-01 01:01:01', INTERVAL 1 YEAR);
       subdate       
---------------------
 2021-01-01 01:01:01
(1 row)

-- 第一参数为DATETIME
 openGauss=# SELECT SUBDATE('2022-01-01 01:01:01', INTERVAL 1 YEAR);
       subdate       
---------------------
 2021-01-01 01:01:01
(1 row)

-- 第一参数为DATE但是INTERVAL的单位包含TIME部分
 openGauss=# SELECT SUBDATE('2022-01-01', INTERVAL 1 SECOND);
       subdate       
---------------------
 2021-12-31 23:59:59
(1 row)
  • SUBDATE(TIME, interval)

    函数原型:

    TIME SUBDATE(TIME time, INTERVAL expr unit)

    TIME SUBDATE(TIME time, int64 days)

    功能描述:

    该函数是为兼容MySql中subdate函数的第一参数类型可以为TIME的情况。该情况下,第一参数的输入必须为原始的TIME数据,而非由字符串的隐式转换而来。 参数time指定开始TIME类型的时间值,第二参数指定要从开始时间减去的INTERVAL值,返回相减后的结果日期值。若第二参数为整数,则将其视为减去的天数值。

    备注:

    • 第一参数必须为原始的TIME类型,而非由字符串的隐式转换而来。如SUBDATE('1:1:1', 1)并不会进入此函数。需改为SUBDATE(time'1:1:1', 1)。
    • 第二参数的INTERVAL单位不能包含年或月部分,否则返回NULL。
    • 返回值必须在[-838:59:59, 838:59:59]内,否则返回NULL。

    示例:

 openGauss=# SELECT SUBDATE(time'10:15:20', INTERVAL '1' DAY), SUBDATE(time'10:15:20', 1);
   subdate  |  subdate  
-----------+-----------
 -13:44:40 | -13:44:40
(1 row)

-- 第二参数的INTERVAL单位不能包含年或月部分
 openGauss=# SELECT SUBDATE(time'838:00:00', INTERVAL '1' MONTH);
 subdate 
---------
 
(1 row)

-- 结果超出范围
 openGauss=# SELECT SUBDATE(time'838:59:59', INTERVAL '-1' SECOND);
 subdate 
---------
 
(1 row)
  • SUBTIME()

    函数原型:

    TEXT SUBTIME(TIME time1, TIME time2)

    TEXT SUBTIME(DATETIME time1, TIME time2)

    功能描述:

    该函数执行日期运算,返回DATETIME或TIME表达式time1减去TIME表达式time2的结果。返回参数类型与time1传入类型保持一致。

    备注:

    • time1需要是正确合法的TIME格式或者DATETIME格式,否则报错。
    • time2需要是正确合法的TIME格式,否则报错。
    • 如返回值超出[-838:59:59, 838:59:59],则会根据符号返回极值。

    示例:

    openGauss=# select subtime('11:22:33','10:20:30');
    subtime  
    ----------
    01:02:03
    (1 row)
    
    openGauss=# select SUBTIME('2020-03-04 11:22:33', '-10:20:30');
        subtime       
    ---------------------
    2020-03-04 21:43:03
    (1 row)
    
  • sysdate(n)

    描述:返回系统实时时间戳,n为精度,最大值取6。

    返回值类型:datetime

    示例:

    openGauss=# select sysdate(3);
        sysdate(3)
    -------------------------
    2022-07-21 17:38:23.442
    (1 row)
    
    openGauss=# select sysdate();
        sysdate()
    ---------------------
    2022-07-21 17:39:02
    (1 row)
    
  • time()

    函数原型:

    Text TIME(TEXT expr)

    功能描述:

    兼容mysql的time()函数。参数指定一个TIME或DATETIME表达式,提取其中的time表达式并返回为字符串。

    备注:

    • 返回的时间表达式中最多保留六位小数,超出部分按照四舍五入进位。
    • 对于异常的日期或时间格式或是域溢出的日期或时间(如1:60:60、2022-12-32 等),本函数兼容mysql中该函数于insert语句中的表现,即报错。
    • date格式字符串将会报错,而date类型参数将会返回"00:00:00"。

    示例:

    openGauss=# select time('2022-1-1 1:1:1.1111116'), time('25:25:25');
          time       |   time   
    -----------------+----------
    01:01:01.111112 | 25:25:25
    (1 row)
    
    openGauss=# select time(date'2022-1-1');
      time   
    ----------
    00:00:00
    (1 row)
    
  • TIMEDIFF()

    函数原型:

    TIME TIMEDIFF(TIME time1, TIME time2)

    DATETIME TIMEDIFF(DATETIME time1, DATETIME time2)

    功能描述:

    该函数执行日期运算,返回time1减去time2的结果。返回参数类型与传入类型保持一致。

    备注:

    • time1, time2类型需要一致且均合法,否则返回NULL。
    • time1, time2均为TIME类型且返回值超出[-838:59:59, 838:59:59],函数将会报错。

    示例:

    openGauss=# select TIMEDIFF(time'23:59:59',time'01:01:01'), TIMEDIFF(datetime'2008-12-31 23:59:59',datetime'2008-12-30 01:01:01');
     timediff | timediff
    ----------+----------
     22:58:58 | 46:58:58
    (1 row)
    
    -- 超出范围时返回极值。
    openGauss=# SELECT TIMEDIFF(time'-830:00:00', time'10:20:30'), TIMEDIFF(time'830:00:00', time'-10:20:30');
      timediff  | timediff
    ------------+-----------
     -838:59:59 | 838:59:59
    (1 row)
    
  • TIMESTAMP()

    函数原型:

    DATETIME TIMESTAMP(TEXT expr)

    DATETIME TIMESTAMP(TEXT expr, TIME time)

    功能描述:

    只有一个参数时,函数将DATE或DATETIME表达式expr转为DATETIME值返回。

    有两个参数时,函数计算DATE或DATETIME表达式expr加上TIME类型time的结果并返回。

    备注:

    • expr为不存在的date或datetime表达式时。如'2000-12-32','2000-1-1 24:00:00'等,函数报错。
    • 包含两个参数且第二参数time为非TIME格式字符串时,函数报错。

    示例:

    openGauss=# select TIMESTAMP('2022-01-01'), TIMESTAMP('20220101');
          timestamp      |      timestamp      
    ---------------------+---------------------
    2022-01-01 00:00:00 | 2022-01-01 00:00:00
    (1 row)
    
    openGauss=# select TIMESTAMP('2022-01-31 12:00:00.123456'), TIMESTAMP('20000229120000.1234567');
            timestamp          |         timestamp          
    ----------------------------+----------------------------
    2022-01-31 12:00:00.123456 | 2000-02-29 12:00:00.123457
    (1 row)
    
    openGauss=# select TIMESTAMP('2022-01-31','12:00:00.123456'), TIMESTAMP('2022-01-31 12:00:00','-32:00:00');
            timestamp          |      timestamp      
    ----------------------------+---------------------
    2022-01-31 12:00:00.123456 | 2022-01-30 04:00:00
    (1 row)
    
    openGauss=# select TIMESTAMP('20000229','100:00:00'), TIMESTAMP('20000229120000.123','100:00:00');
         timestamp      |       timestamp
    ---------------------+-------------------------
     2000-03-04 04:00:00 | 2000-03-04 16:00:00.123
    (1 row)
    
  • timestamp_add()

    函数原型:

    TEXT TIMESTAMP_ADD(text unit, interval span, text datetime)

    功能描述:

    将一段时间加到已知的时间点上。其中第一个参数unit是时间单位,第二个参数span是具体数值,第三个参数datetime是已知时间点。

    备注:

    • unit支持的单位如下:

      单位对应的输入
      year
      季度qtr
      month
      week
      day
      hour
      minute
      second
      微秒microsecon
    • span支持小数。当unit为秒时,span根据第七位小数,四舍五入到六位小数;否则span四舍五入到整数。

    • datetime的输入类型可以是字符串、date、datetime、time。

    • datetime的输入范围和函数的计算结果均需落在区间[0001-01-01 00:00:00.000000, 9999-12-31 23:59:59.999999]内,否则报错(兼容mysql中该函数于insert语句的表现)。

    • 对于异常的日期或时间格式或是域溢出的日期或时间(如1:60:60、2022-12-32 等),本函数兼容mysql中该函数于insert语句中的表现,即报错。

    示例:

    openGauss=# select timestampadd(day, 1, '2022-09-01');
     timestampadd 
    --------------
     2022-09-02
    (1 row)
    
    openGauss=# select timestampadd(hour, 1, '2022-09-01 08:00:00');
        timestampadd     
    ---------------------
     2022-09-01 09:00:00
    (1 row)
    
  • time_format()

    函数原型:

    TEXT TIME_FORMAT(text time, text format)。

    功能描述:

    第一参数time为time或datetime表达式,函数基于第二参数format格式化time值并返回为字符串。

    备注:

    • format支持的格式如下:
      格式描述
      %f微秒(000000至999999)
      %H小时(00到23)
      %h小时(00到12)
      %I小时(00到12)
      %i分钟(00至59)
      %pAM or PM
      %r时间为12小时AM或PM格式(hh:mm:ss AM / PM)
      %S秒(00到59)
      %s秒(00到59)
      %T24小时格式的时间(hh:mm:ss)
      %k小时数
    • 对于非时分秒相关的格式,会返回0或NULL,包括:
格式返回结果
%a、%b、%D、%j、%M、%U、%u、%V、%v、%W、%w、%X、%xNULL
%c 、%e0
%d、%m、%y00
%Y0000

提取的时间值最多保留六位小数,超出部分按照四舍五入进位。

示例:

openGauss=# select TIME_FORMAT('83:59:59.0000009', '%T|%r|%H|%h|%I|%i|%S|%f|%p|%k');
                  time_format                    
--------------------------------------------------
83:59:59|11:59:59 AM|83|11|11|59|59|000001|AM|83
(1 row)

openGauss=# select TIME_FORMAT('2022-1-1 23:59:59.0000009', '%T|%r|%H|%h|%I|%i|%S|%f|%p|%k');
                  time_format                    
--------------------------------------------------
23:59:59|11:59:59 PM|23|11|11|59|59|000001|PM|23
  • weekday(timestamp)

    描述:获取日期/时间值中是一周中的星期几(0代表星期一,1代表星期二,以此类推,6代表星期日)。

    返回值类型:double precision

    示例:

    openGauss=# SELECT weekday(timestamp '2001-02-16 20:38:40.123');
     ?column?
    ----------
            4
    (1 row)
    
  • weekofyear(timestamp)

    描述:获取日期/时间值中是一年的第几周。

    返回值类型:double precision

    示例:

    openGauss=# SELECT weekofyear(timestamp '2001-02-16 20:38:40.123');
     date_part
    -----------
            7
    (1 row)
    
  • year(timestamp)

    描述:获取日期/时间值中的年数。

    返回值类型:double precision

    示例:

    openGauss=# SELECT year(timestamp '2001-02-16 20:38:40.123');
     year
    ------
     2001
    (1 row)
    
  • current_date()

    描述:当前日期。

    返回值类型:date

    示例:

    openGauss=# SELECT current_date;
        date    
    ------------
     2017-09-01
    (1 row)
    
  • to_days()

    函数原型:int8 TO_DAYS(DATETIME date)

    功能描述:接受一个date或datetime表达式作为参数,返回参数所指定的日期到0000年所经过的天数

    备注:

    • 若入参类型为time类型,将用于计算的日期将为当前日期加上time指定时间后得到的日期。
    • 若输入日期超出[0000-01-01, 9999-12-31]的范围或入参为非法的date或datetime表达式,函数报错。

    示例:

    opengauss=# select to_days('0000-01-01');
     to_days 
    ---------
           1
    (1 row)
    
    opengauss=# select to_days('2022-09-05 23:59:59.5');
     to_days 
    ---------
      738768
    (1 row)
    
    -- 当前日期为: 2022-09-05
    opengauss=# select to_days(time'25:00:00');
     to_days 
    ---------
      738769
    (1 row)
    
  • to_seconds()

    函数原型:NUMERIC TO_SECONDS(text datetime)

    功能描述:输入一个时间点datetime,返回0000-01-01 00:00:00到该时间点所经过的秒数

    备注:

    • 参数datetime支持的类型有:字符串、数值、date、datetime、time等。当输入参数为time类型时,日期会被自动设置为当前日期。
    • 返回的结果只保留整秒数,小数部分直接舍弃。

    示例:

    opengauss=# select to_seconds('2022-09-01');
     to_seconds  
    -------------
     63829209600
    (1 row)
    
    opengauss=# select to_seconds('2022-09-01 12:30:30.888');
     to_seconds  
    -------------
     63829254630
    (1 row)
    
    opengauss=# select to_seconds(20220901123030);
     to_seconds  
    -------------
     63829254630
    (1 row)
    
  • unix_timestamp()

    函数原型:

    NUMERIC UNIX_TIMESTAMP()

    NUMERIC UNIX_TIMESTAMP(text datetime)

    功能描述:

    • 不输入任何参数,直接执行该函数,返回1970-01-01 00:00:00 UTC到当前时间点所经过的秒数
    • 输入一个时间点datetime,返回1970-01-01 00:00:00 UTCdatetime所经过的秒数

    备注:

    • 参数datetime支持的类型有:字符串、数值、date、datetime、time等。当输入参数为time类型时,日期会被自动设置为当前日期。
    • 参数datetime的有效范围为[1970-01-01 00:00:00.000000 UTC, 2038-01-19 03:14:07.999999 UTC]
    • 参数的输入范围会受到时区的影响,但最终计算结果不受时区影响。
    • 计算结果最多只保留六位小数。

    示例:

    opengauss=# select unix_timestamp('2022-09-01');
     unix_timestamp 
    ----------------
         1661961600
    (1 row)
    
    opengauss=# select unix_timestamp('2022-09-01 12:30:30.888');
     unix_timestamp 
    ----------------
     1662006630.888
    (1 row)
    
    opengauss=# select unix_timestamp(20220901123030.6);
     unix_timestamp 
    ----------------
       1662006630.6
    (1 row)
    
  • utc_date()

    函数原型:DATE UTC_DATE()

    功能描述:返回当前的UTC日期,类型为DATE。

    备注:

    • UTC_DATE能够以关键词的形式识别,此时无需包含括号。

    示例:

    opengauss=# select UTC_DATE();
      utc_date  
    ------------
     2022-09-06
    (1 row)
    
    opengauss=# select UTC_DATE;
      utc_date  
    ------------
     2022-09-06
    (1 row)
    
  • utc_time()

    函数原型:

    TIME UTC_TIME()

    TIME UTC_TIME(int fsp)

    功能描述:返回当前的UTC时间,类型为TIME。若给定一个整数参数作为精度,则能够指定结果保留的小数数量,支持精度范围为[0-6]

    备注:

    • UTC_TIME能够以关键词的形式识别,此时无需包含括号。效果等同于无参数的UTC_TIME()函数。

    示例:

    opengauss=# select UTC_TIME();
     utc_time 
    ----------
     15:13:54
    (1 row)
    
    opengauss=# select UTC_TIME(6);
        utc_time    
    ----------------
     15:13:56.59698
    (1 row)
    
    opengauss=# select UTC_TIME;
     utc_time 
    ----------
     15:14:01
    (1 row)
    
  • utc_timestamp()

    函数原型:

    • DATETIME UTC_TIMESTAMP()
    • DATETIME UTC_TIMESTAMP(int fsp)

    功能描述:返回当前的UTC日期时间值,类型为DATETIME。若给定一个整数参数作为精度,则能够指定结果保留的小数数量,支持精度范围为[0-6]。

    备注:

    • UTC_TIMESTAMP能够以关键词的形式识别,此时无需包含括号。效果等同于无参数的UTC_TIMESTAMP()函数。

    示例:

    opengauss=# select UTC_TIMESTAMP();
        utc_timestamp    
    ---------------------
     2022-09-06 15:16:28
    (1 row)
    
    opengauss=# select UTC_TIMESTAMP(6);
           utc_timestamp        
    ----------------------------
     2022-09-06 15:16:34.691118
    (1 row)
    
    opengauss=# select UTC_TIMESTAMP;
        utc_timestamp    
    ---------------------
     2022-09-06 15:16:39
    
  • date_bool(date)

    描述:根据日期值中的年数返回布尔型(为零时返回false,否则返回true)。

    返回值类型:boolean

    示例:

    openGauss=# select time_bool('18:50:00');
     time_bool 
    -----------
     t
    (1 row)
    
    openGauss=# select time_bool('00:50:00');
     time_bool 
    -----------
     f
    (1 row)
    
  • time_bool(time)

    描述:根据时间值中的小时数返回布尔型(为零时返回false,否则返回true)。

    返回值类型:boolean

    示例:

    openGauss=# select date_bool('2022-08-20');
     date_bool 
    -----------
     t
    (1 row)
    
    openGauss=# select date_bool('0000-08-20');
     date_bool 
    -----------
     f
    (1 row)
    
  • dayname(date)

    描述:返回日期对应的工作日,返回内容所在语言集受GUC参数lc_time_names控制。

    返回值类型:text

    备注:此函数兼容MySQL插表时参数及结果约束。

    示例:

    openGauss=# select dayname('2000-1-1');
    dayname
    ----------
    Saturday
    (1 row)
    
    openGauss=# alter system set lc_time_names = 'zh_CN';
    ALTER SYSTEM SET
    
    openGauss=# select dayname('2000-1-1');
    dayname
    ---------
    星期六
    (1 row)
    
  • monthname(date)

    描述:返回日期对应月份的全称,返回内容所在语言集受GUC参数lc_time_names控制。

    返回值类型:text

    备注:此函数兼容MySQL插表时参数及结果约束。

    示例:

    openGauss=# select monthname('2000-1-1');
    monthname
    -----------
    January
    (1 row)
    
    openGauss=# alter system set lc_time_names = 'zh_CN';
    ALTER SYSTEM SET
    
    openGauss=# select monthname('2000-1-1');
    monthname
    -----------
    一月
    (1 row)
    
  • time_to_sec(time)

    描述:将时间转换为秒数。

    返回值类型:integer

    备注:此函数兼容MySQL插表时参数及结果约束。

    示例:

    openGauss=# select time_to_sec('838:59:59');
    time_to_sec
    -------------
        3020399
    (1 row)
    
    openGauss=# select time_to_sec('-838:59:59');
    time_to_sec
    -------------
        -3020399
    (1 row)
    
  • month(date)

    描述:返回日期中的月份。

    返回值类型:integer

    备注:此函数兼容MySQL插表时参数及结果约束。

    示例:

    openGauss=# select month('2021-11-12');
    month
    -------
        11
    (1 row)
    
    openGauss=# select month('2021-11-0');
    month
    -------
        11
    (1 row)
    
  • day(date)

    描述:返回日期中的天数。

    返回值类型:integer

    备注:此函数兼容MySQL插表时参数及结果约束。

    示例:

    openGauss=# select day('2021-11-12');
    day
    -----
    12
    (1 row)
    
    openGauss=# select day('2021-0-0');
    day
    -----
    0
    (1 row)
    
  • date(expr)

    描述:expr识别为date或者datetime表达式,从expr中提取出日期部分。

    返回值类型:text

    备注:此函数兼容MySQL插表时参数及结果约束。

    示例:

    openGauss=# select date('2021-11-12');
        date
    ------------
    2021-11-12
    (1 row)
    
    openGauss=# select date('2021-11-12 23:59:59.9999999');
        date
    ------------
    2021-11-13
    (1 row)
    
    openGauss=# select date('2021-11-0');
        date
    ------------
    2021-11-00
    (1 row)
    
    openGauss=# select date('2021-0-3');
        date
    ------------
    2021-00-03
    (1 row)
    
  • last_day(expr)

    描述:expr识别为date或者datetime,返回该月对应的最后一天的日期。

    返回值类型:date

    备注:此函数兼容MySQL插表时参数及结果约束。在B模式数据库中,当GUC参数b_compatibility_mode为true时,此函数代替openGauss原有last_day函数。

    示例:

    openGauss=# set b_compatibility_mode = true;
    SET
    
    openGauss=# select last_day('2021-1-30');
    last_day
    ------------
    2021-01-31
    (1 row)
    
    openGauss=# select last_day('2021-1-0');
    last_day
    ------------
    2021-01-31
    (1 row)
    
  • week(date[,mode])

    描述:返回date参数代表的日期在一年中的第几周。mode参数为可选整型参数,范围为[0,7]。无mode参数传入时,GUC参数default_week_format会作为默认mode参数。

    mode参数的各种取值及其意义如下:

    mode意义
    0Sunday为一周的第一天;week的取值范围为[0-53];一年的第一周必须包含Sunday
    1Monday为一周的第一天;week的取值范围为[0-53];一年的第一周必须有大于等于4天在此年内
    2Sunday为一周的第一天;week的取值范围为[1-53];一年的第一周必须包含Sunday
    3Monday为一周的第一天;week的取值范围为[1-53];一年的第一周必须有大于等于4天在此年内
    4Sunday为一周的第一天;week的取值范围为[0-53];一年的第一周必须有大于等于4天在此年内
    5Monday为一周的第一天;week的取值范围为[0-53];一年的第一周必须包含Monday
    6Sunday为一周的第一天;week的取值范围为[1-53];一年的第一周必须有大于等于4天在此年内
    7Monday为一周的第一天;week的取值范围为[1-53];一年的第一周必须包含Monday

    对于一周的第一天week取值范围判定一年第一周的条件的说明:

    • 一周的第一天指一周开始的那一天,Monday或者Sunday可能为一周的第一天。
    • week取值范围指WEEK函数返回值的取值范围,有[0-53]和[1-53]两种取值范围。其中[0-53]中的0代表给定日期实际位于其所在年份上一年的最后一周内,但为了将返回结果与给定日期所在年份联系起来,故认为给定日期位于其所在年份的第零周(也即还未开始第一周)。若希望给定日期所在周数与其所在年份关系更紧密,则应该使用0、1、4或者5作为mode值,这样,当给定日期位于其所在年份上一年的最后一周时,WEEK函数会返回0。
    • 判定一年第一周的条件指判定所给日期位于当前年的第一周的条件,一般而言只有日期位于年份的边界才会进行判定。此判定有两种方式,由mode参数决定使用哪种方式。
      • 方式一:若Monday或者Sunday是一周的第一天,并且Monday或者Sunday在给定日期所在年内,则此周为日期所在年份的第一周。对应mode取值为0、2、5和7。
      • 方式二:若给定日期所在的周有大于等于4天位于日期所在年内,则此周为日期所在年份的第一周;否则此周为上一年的最后一周。对应mode取值为1、3、4和6。

    返回值类型:integer

    备注:此函数兼容MySQL插表时参数及结果约束。

    示例:

    openGauss=# show default_week_format;
    default_week_format
    ---------------------
    0
    (1 row)
    
    -- 给定日期位于前一年的最后一周内,mode为0
    openGauss=# select week('2000-1-1');
    week
    ------
        0
    (1 row)
    
    openGauss=# alter system set default_week_format = 2;
    ALTER SYSTEM SET
    
    -- 给定日期位于前一年的最后一周内,mode为2
    openGauss=# select week('2000-1-1');
    week
    ------
    52
    (1 row)
    
    openGauss=# select week('2000-1-1', 2);
    week
    ------
    52
    (1 row)
    
  • yearweek(date[,mode])

    描述:返回date参数代表的日期所在的年份和周。mode为可选整型参数,取值范围为[0,7]。无mode参数传入时,0会作为默认mode参数,GUC参数default_week_format不会影响yearweek函数。mode参数详细意义参见week函数。

    yearweek函数不会返回0周,即week取值范围始终为[1-53],不受mode参数影响。

    返回值类型:bigint

    备注:此函数兼容MySQL插表时参数及结果约束。

    示例:

    openGauss=# select week('1987-01-01', 0);
    week
    ------
        0
    (1 row)
    
    openGauss=# select yearweek('1987-01-01', 0);
    yearweek
    ----------
    198652
    (1 row)
    
  • datediff(expr1,expr2)

    描述:expr1和expr2可以是date或者datetime,计算expr1-expr2代表的天数,只有expr1和expr2的日期部分参与计算。当输入参数不合法时,该函数返回NULL。

    返回值类型:integer(代表日期差值,单位是天)

    示例:

    openGauss=# select datediff('2001-01-01','321-02-02');
    datediff 
    ----------
     613576
    (1 row)
    
  • from_days(N)

    描述:返回数值N代表的天数对应日期。

    返回值类型:date

    示例:

    openGauss=# select from_days(365);
    from_days  
    ------------
    0000-00-00
    (1 row)
    
    openGauss=# select from_days(366);
    from_days  
    ------------
    0001-01-01
    (1 row)
    
  • timestampdiff(unit,datetime expr1,datetime expr2)

    描述:函数返回两个日期参数expr2 - expr1的值,这两个参数都有可能是datetime或者是date,如果参数是date,则认为时间部分为0。计算差值之后,将计算结果转换成指定单位显示。unit有以下值:MICROSECOND , SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, QUARTER, 或者是 YEAR。当输入参数不合法时,此函数返回NULL。

    返回值类型:bigint(代表以指定单位显示的差值)

    备注:在B模式数据库中,此函数在GUC参数b_compatibility_mode为true时代替openGauss原有timestampdiff函数。

    示例:

    openGauss=# set b_compatibility_mode = true;
    SET
    
    openGauss=# select timestampdiff(SECOND,'2001-01-01 12:12:12','2001-01-01 12:12:11');
    timestampdiff
    ---------------
                -1
    (1 row)
    
    openGauss=# select timestampdiff(MONTH,'2001-01-01 12:12:12','2001-02-01 12:12:12');
    timestampdiff
    ---------------
                1
    (1 row)
    
  • convert_tz(datetime, from_tz, to_tz)

    描述:将datetime从from_tz指定的时区转换到to_tz指定的时区。如果datetime从from_tz转换到UTC时区时范围超过[1970-01-01 00:00:01.000000, 2038-01-19 03:14:07.999999],则不进行转换。参数无效时,函数返回NULL。

    返回值:datetime

    示例:

    openGauss=# SELECT CONVERT_TZ('2004-01-01 12:00:00','GMT','MET');
          convert_tz
    ---------------------
      2004-01-01 13:00:00
    (1 row)
    
  • DATE_ADD(date/datetime/time, interval expr unit)

    函数原型:

    text DATE_ADD(text expr1, INTERVAL expr2 unit)
    time DATE_ADD(time expr1, INTERVAL expr2 unit)
    

    描述:该函数执行日期时间加法运算,返回exrp1加expr2的结果。expr1可以为date/datetime/time类型的数据,expr2代表interval值。expr1为time类型的数据时,只能在显示声明参数类型为time时才能实现对time的加法。

    返回值类型:与第一参数类型保持一致。

    备注:

    • 一般情况下,返回类型与第一参数的类型相同。当第一参数的类型为DATE时且INTERVAL的单位包含HOUR、MINUTE、SECOND部分,则返回结果为DATETIME。
    • 参数限制:MySQL插表时参数限制。
      • expr1为date/datetime格式时,若超出[0000-1-1 00:00:00.000000, 9999-12-31 23:59:59.999999],则报错。
      • expr1为time类型的数据时,只能在显示声明参数类型为time时才能实现对time的加法。如date_add('1:1:1',interval 1 second)并不会进入此函数,需改为date_add(time'1:1:1', interval 1 second)。
    • 结果限制:MySQL插表时结果限制。
      • expr1为date/datetime格式时,若结果超出[0000-1-1 00:00:00.000000, 9999-12-31 23:59:59.999999],则报错;若结果在此范围内,但小于'0001-1-1 00:00:00.000000',MySQL中将结果定为'0000-00-00'或者'0000-00-00 xx:xx:xx',其中时间部分结果视具体计算结果而定。鉴于这样的结果没有意义,故在openGauss中报错。
      • 对第一参数为time类型的数据,如果计算结果超出time类型范围[-838:59:59, 838:59:59],报错。

    示例:

    openGauss=# SELECT DATE_ADD('2022-01-01', INTERVAL 31 DAY);
      date_add
    ------------
    2022-02-01
    (1 row)
    
    openGauss=# SELECT DATE_ADD('2022-01-01 01:01:01', INTERVAL 1 YEAR);
        date_add       
    ---------------------
    2023-01-01 01:01:01
    (1 row)
    
    openGauss=# SELECT DATE_ADD('2022-01-01', INTERVAL 1 SECOND);
        date_add       
    ---------------------
    2022-01-01 00:00:01
    (1 row)
    
  • DATE_SUB(date/datetime/time, interval expr unit)

    函数原型:

      text DATE_SUB(text expr1, INTERVAL expr2 unit)
      time DATE_SUB(time expr1, INTERVAL expr2 unit)
    

    描述:该函数执行日期时间减法运算,返回exrp1减expr2的结果。expr1可以为date/datetime/time类型的数据,expr2代表interval值。expr1为time类型的数据时,只能在显示声明参数类型为time时才能实现对time的减法。

    返回值类型:与第一参数类型保持一致。

    备注:

    • 一般情况下,返回类型与第一参数的类型相同。当第一参数的类型为DATE时且INTERVAL的单位包含HOUR、MINUTE、SECOND部分,则返回结果为DATETIME。
    • 参数限制:MySQL插表时参数限制。
      • expr1为date/datetime格式时,若超出[0000-1-1 00:00:00.000000, 9999-12-31 23:59:59.999999],则报错。
      • expr1为time类型的数据时,只能在显示声明参数类型为time时才能实现对time的减法。如date_sub('1:1:1',interval 1 second)并不会进入此函数,需改为date_sub(time'1:1:1', interval 1 second)。
    • 结果限制:MySQL插表时结果限制。
      • expr1为date/datetime格式时,若结果超出[0000-1-1 00:00:00.000000, 9999-12-31 23:59:59.999999],则报错;若结果在此范围内,但小于'0001-1-1 00:00:00.000000',MySQL中将结果定为'0000-00-00'或者'0000-00-00 xx:xx:xx',其中时间部分结果视具体计算结果而定。鉴于这样的结果没有意义,故在openGauss中报错。
      • 对第一参数为time类型的数据,如果计算结果超出time类型范围[-838:59:59, 838:59:59],报错。

    示例:

    openGauss=# SELECT DATE_SUB('2022-01-01', INTERVAL 31 DAY);
      date_sub
    ------------
    2021-12-01
    (1 row)
    
    openGauss=# SELECT DATE_SUB('2022-01-01 01:01:01', INTERVAL 1 YEAR);
        date_sub       
    ---------------------
    2021-01-01 01:01:01
    (1 row)
    
    
    openGauss=# SELECT DATE_SUB('2022-01-01', INTERVAL 1 SECOND);
        date_sub       
    ---------------------
    2021-12-31 23:59:59
    (1 row)
    
  • ADDDATE(date/datetime/time, interval/days)

    描述:该函数执行日期或时间加法运算。当第二参数为interval时,该函数表现与DATE_ADD函数相同,详细描述参见DATE_ADD。当第二参数为整数时,此整数会被当作天数加在第一参数上。

    示例:

    openGauss=# SELECT ADDDATE('2021-11-12', INTERVAL 1 SECOND);
          adddate
    ---------------------
    2021-11-12 00:00:01
    (1 row)
    
    openGauss=# SELECT ADDDATE(time'12:12:12', INTERVAL 1 DAY);
    adddate
    ----------
    36:12:12
    (1 row)
    
    openGauss=# SELECT ADDDATE('2021-11-12', 1);
      adddate
    ------------
    2021-11-13
    (1 row)
    
    openGauss=# SELECT ADDDATE(time'12:12:12', 1);
    adddate
    ----------
    36:12:12
    (1 row)
    
  • ADDTIME(datetime/time,time)

    函数原型:

    time ADDTIME(text expr1, time expr2)
    

    描述:该函数执行时间加法运算,返回expr1加上expr2的结果。expr1可以为datetime或者time格式,expr2只能为time格式。

    返回值类型:与第一参数类型保持一致。

    备注:

    • 参数限制:MySQL插表时参数限制。

      • 第一参数为datetime格式时,若超出[0000-1-1 00:00:00.000000 , 9999-12-31 23:59:59.999999],则报错。
      • 第一参数为time格式时,若超过time类型范围,则报错。
      • 第二参数只能为time格式。
    • 结果限制:MySQL插表时结果限制。

      • 结果为datetime格式时,若超出[0000-1-1 00:00:00.000000, 9999-12-31 23:59:59.999999],则报错;若结果在此范围内,但小于'0001-1-1 00:00:00.000000',则函数返回NULL。
      • 结果为time格式时,若超出[-838:59:59, 838:59:59]则报错。

    示例:

    openGauss=# SELECT ADDTIME('11:22:33','10:20:30');
    addtime  
    ----------
    21:43:03
    (1 row)
    
    openGauss=# SELECT ADDTIME('2020-03-04 11:22:33', '-10:20:30');
    addtime       
    ---------------------
    2020-03-04 01:02:03
    (1 row)
    
意见反馈
编组 3备份
    openGauss 2024-03-28 00:49:54
    取消