文档首页> 数据仓库服务 GaussDB(DWS)> 语法参考（阿布扎比区域）> 函数和操作符> 时间、日期处理函数和操作符

更新时间：2024-03-06 GMT+08:00

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

时间日期操作符

用户在使用时间和日期操作符时，对应的操作数请使用明确的类型前缀修饰，以确保数据库在解析操作数的时候能够与用户预期一致，不会产生用户非预期的结果。

比如下面示例没有明确数据类型就会出现异常错误。

      
           SELECT date '2001-10-01' - '7' AS RESULT;
ERROR:  invalid input syntax for type timestamp: "7"

表1 时间和日期操作符

操作符

示例

date类型参数与integer参数相加，获取时间间隔为7天后的时间：

        
             SELECT date '2001-09-28' + integer '7' AS RESULT;
       result        
---------------------
 2001-10-05 00:00:00
(1 row)

date类型参数与interval参数相加，获取时间间隔为1小时后的时间：

        
             SELECT date '2001-09-28' + interval '1 hour' AS RESULT;
       result        
---------------------
 2001-09-28 01:00:00
(1 row)

date类型参数与time类型参数相加，获取具体的日期和时间结果：

        
             SELECT date '2001-09-28' + time '03:00' AS RESULT;
       result        
---------------------
 2001-09-28 03:00:00
(1 row)

date类型参数与interval参数相加，获取时间间隔为1个月的时间：

date函数对于日期相加减超过月份的日期范围，会对齐到对应月份最后一天，不超过则不处理。例如：2021-01-31后一个月的日期为2021-02-31，但2月为闰月，只有28天，那么date函数会返回对齐到2月份最后一天的结果，即2021-02-28。

        
             SELECT date '2021-01-31' + interval '1 month' AS RESULT;
       result
---------------------
 2021-02-28 00:00:00
(1 row)

        
             SELECT date '2021-02-28' + interval '1 month' AS RESULT;
       result
---------------------
 2021-03-28 00:00:00
(1 row)

interval参数相加，获取两个时间间隔之和：

        
             SELECT interval '1 day' + interval '1 hour' AS RESULT;
     result     
----------------
 1 day 01:00:00
(1 row)

timestamp时间类型参数与interval参数相加，获取间隔23小时后的时间：

        
             SELECT timestamp '2001-09-28 01:00' + interval '23 hours' AS RESULT;
       result        
---------------------
 2001-09-29 00:00:00
(1 row)

time类型参数与interval参数相加，获取间隔时间为3小时后的时间：

        
             SELECT time '01:00' + interval '3 hours' AS RESULT;
  result  
----------
 04:00:00
(1 row)

date类型参数相减，获取两个日期的时间差：

        
             SELECT date '2001-10-01' - date '2001-09-28' AS RESULT;
 result 
--------
 3 days
(1 row)

date类型参数与integer参数相减，返回timestamp类型，获取两者的时间差：

        
             SELECT date '2001-10-01' - integer '7' AS RESULT;
       result        
---------------------
 2001-09-24 00:00:00
(1 row)

date类型参数与interval参数相减，获取两者的日期、时间差：

        
             SELECT date '2001-09-28' - interval '1 hour' AS RESULT;
       result        
---------------------
 2001-09-27 23:00:00
(1 row)

time类型参数相减，获取两参数的时间差：

        
             SELECT time '05:00' - time '03:00' AS RESULT;
  result  
----------
 02:00:00
(1 row)

time类型参数与interval相减，获取两参数的时间差：

        
             SELECT time '05:00' - interval '2 hours' AS RESULT;
  result  
----------
 03:00:00
(1 row)

timestamp类型参数与interval相减，从时间戳中减去时间间隔，获取两者的日期时间差：

        
             SELECT timestamp '2001-09-28 23:00' - interval '23 hours' AS RESULT;
       result        
---------------------
 2001-09-28 00:00:00
(1 row)

interval参数相减，获取两者的时间差：

        
             SELECT interval '1 day' - interval '1 hour' AS RESULT;
  result  
----------
 23:00:00
(1 row)

timestamp类型参数相减，获取两者的日期时间差：

        
             SELECT timestamp '2001-09-29 03:00' - timestamp '2001-09-27 12:00' AS RESULT;
     result     
----------------
 1 day 15:00:00
(1 row)

获取当前日期的前一天：

        
             SELECT now() - interval '1 day'AS RESULT;
           result
-------------------------------
 2022-08-08 01:46:15.555406+00
(1 row)

将时间间隔乘以数量：

        
             SELECT 900 * interval '1 second' AS RESULT;
  result  
----------
 00:15:00
(1 row)

        
             SELECT 21 * interval '1 day' AS RESULT;
 result  
---------
 21 days
(1 row)

        
             SELECT double precision '3.5' * interval '1 hour' AS RESULT;
  result  
----------
 03:30:00
(1 row)

用时间间隔除以数量，获取一段时间中的某一段：

        
             SELECT interval '1 hour' / double precision '1.5' AS RESULT;
  result  
----------
 00:40:00
(1 row)

时间/日期函数

age(timestamp, timestamp)

描述：将两个参数相减，并以年、月、日作为返回值。若相减值为负，则函数返回亦为负。

返回值类型：interval

示例：

      
           SELECT age(TIMESTAMP '2001-04-10', TIMESTAMP '1957-06-13');
           age           
-------------------------
 43 years 9 mons 27 days
(1 row)

age(timestamp)

描述：当前时间和参数相减。

返回值类型：interval

示例：

      
           SELECT age(TIMESTAMP '1957-06-13');
           age           
-------------------------
 60 years 2 mons 18 days
(1 row)

timestampdiff(field, timestamp1, timestamp2)

描述：将两个日期参数相减(timestamp2 - timestamp1)，并以单位field作为返回值。若相减值为负，则函数返回值为负。field支持的参数为day、month、quarter、day、week、hour、minute、second和microsecond。

返回值类型：bigint

示例：

      
           SELECT timestampdiff(DAY, TIMESTAMP '2001-02-01', TIMESTAMP '2003-05-01 12:05:55');
 timestampdiff 
---------------
      819
(1 row)

clock_timestamp()

描述：实时时钟的当前时间戳。

返回值类型：timestamp with time zone

示例：

      
           SELECT clock_timestamp();
        clock_timestamp        
-------------------------------
 2017-09-01 16:57:36.636205+08
(1 row)

current_date

描述：当前日期。

返回值类型：date

示例：

      
           SELECT current_date;
    date    
------------
 2017-09-01
(1 row)

current_time

描述：当前时间。

返回值类型：time with time zone

示例：

      
           SELECT current_time;
       timetz       
--------------------
 16:58:07.086215+08
(1 row)

current_timestamp

描述：当前日期及时间。

返回值类型：timestamp with time zone

示例：

      
           SELECT current_timestamp;
       pg_systimestamp        
------------------------------
 2017-09-01 16:58:19.22173+08
(1 row)

date_part(text, timestamp)

描述：

获取小时的值。

等效于extract(field from times...。

返回值类型：double precision

示例：

      
           SELECT date_part('hour', TIMESTAMP '2001-02-16 20:38:40');
 date_part 
-----------
        20
(1 row)

date_part(text, interval)

描述：

获取月份的值。如果大于12，则取与12的模。

等效于extract(field from times...。

返回值类型：double precision

示例：

      
           SELECT date_part('month', interval '2 years 3 months');
 date_part 
-----------
         3
(1 row)

date_trunc(text, timestamp)

描述：截取到参数text指定的精度。

返回值类型：timestamp

示例：

      
           SELECT date_trunc('hour', TIMESTAMP  '2001-02-16 20:38:40');
     date_trunc      
---------------------
 2001-02-16 20:00:00
(1 row)

trunc(timestamp)

描述：默认按天截取。

示例：

      
           SELECT trunc(TIMESTAMP  '2001-02-16 20:38:40');                                                                                                                                                                   trunc
---------------------
2001-02-16 00:00:00
(1 row)

extract(field from timestamp)

描述：获取小时的值。

返回值类型：double precision

示例：

      
           SELECT extract(hour FROM TIMESTAMP '2001-02-16 20:38:40');
 date_part 
-----------
        20
(1 row)

extract(field from interval)

描述：获取月份的值。如果大于12，则取与12的模。

返回值类型：double precision

示例：

      
           SELECT extract(MONTH FROM interval '2 years 3 months');
 date_part 
-----------
         3
(1 row)

isfinite(date)

描述：测试是否为有效日期。

返回值类型：boolean

示例：

      
           SELECT isfinite(date '2001-02-16');
 isfinite 
----------
 t
(1 row)

isfinite(timestamp)

描述：测试判断是否为有效时间。

返回值类型：boolean

示例：

      
           SELECT isfinite(TIMESTAMP '2001-02-16 21:28:30');
 isfinite 
----------
 t
(1 row)

isfinite(interval)

描述：测试是否为有效时间间隔。

返回值类型：boolean

示例：

      
           SELECT isfinite(interval '4 hours');
 isfinite 
----------
 t
(1 row)

justify_days(interval)

描述：将时间间隔以30天为单位，表示为月。

返回值类型：interval

示例：

      
           SELECT justify_days(interval '35 days');
 justify_days 
--------------
 1 mon 5 days
(1 row)

justify_hours(interval)

描述：将时间间隔以24小时为单位，表示为天。

返回值类型：interval

示例：

      
           SELECT justify_hours(interval '27 HOURS');
 justify_hours  
----------------
 1 day 03:00:00
(1 row)

justify_interval(interval)

描述：结合justify_days和justify_hours，调整interval。

返回值类型：interval

示例：

      
           SELECT JUSTIFY_INTERVAL(INTERVAL '1 MON -1 HOUR');
 justify_interval 
------------------
 29 days 23:00:00
(1 row)

localtime

描述：当前时间。

返回值类型：time

示例：

      
           SELECT localtime;
     time
----------------
 16:05:55.664681
(1 row)

localtimestamp

描述：当前日期及时间。

返回值类型：timestamp

示例：

      
           SELECT localtimestamp;
         timestamp          
----------------------------
 2017-09-01 17:03:30.781902
(1 row)

now()

描述：当前事务开始的时间戳。

返回值类型：timestamp with time zone

示例：

      
           SELECT now();
              now              
-------------------------------
 2017-09-01 17:03:42.549426+08
(1 row)

numtodsinterval(num, interval_unit)

描述：将数字转换为interval类型。num为numeric类型数字，interval_unit为固定格式字符串（'DAY' | 'HOUR' | 'MINUTE' | 'SECOND'）。

可以通过设置参数IntervalStyle为oracle，兼容该函数在Oracle中的interval输出格式。

示例：

      
           SELECT numtodsinterval(100, 'HOUR');
 numtodsinterval 
-----------------
 100:00:00
(1 row)

SET intervalstyle = oracle;
SET
SELECT numtodsinterval(100, 'HOUR');
        numtodsinterval
-------------------------------
 +000000004 04:00:00.000000000
(1 row)

pg_sleep(seconds)
描述：将当前会话的进行暂停指定的秒数。

返回值类型：void

示例：
1 2 3 4 5

SELECT pg_sleep(10); pg_sleep ---------- (1 row)

statement_timestamp()

描述：当前日期及时间。

返回值类型：timestamp with time zone

示例：

      
           SELECT statement_timestamp();
      statement_timestamp      
-------------------------------
 2017-09-01 17:04:39.119267+08
(1 row)

sysdate

描述：当前日期及时间。

返回值类型：timestamp

示例：

      
           SELECT sysdate;
       sysdate       
---------------------
 2017-09-01 17:04:49
(1 row)

timeofday()

描述：当前日期及时间（像clock_timestamp，但是返回时为text。）

返回值类型：text

示例：

      
           SELECT timeofday();
              timeofday              
-------------------------------------
 Fri Sep 01 17:05:01.167506 2017 CST
(1 row)

transaction_timestamp()

描述：当前日期及时间，与•current_timestamp等效。

返回值类型：timestamp with time zone

示例：

      
           SELECT transaction_timestamp();
     transaction_timestamp     
-------------------------------
 2017-09-01 17:05:13.534454+08
(1 row)

add_months(d,n)

描述：用于计算时间点d再加上n个月的时间。

返回值类型：timestamp

示例：

      
           SELECT add_months(to_date('2017-5-29', 'yyyy-mm-dd'), 11);
     add_months      
---------------------
 2018-04-29 00:00:00
(1 row)

last_day(d)

描述：用于计算时间点d本月最后一天的时间。

ORA和TD兼容模式下，返回值类型为timestamp。
MySQL兼容模式下，返回值类型为date。

示例：

      
           select last_day(to_date('2017-01-01', 'YYYY-MM-DD')) AS cal_result;
     cal_result      
---------------------
 2017-01-31 00:00:00
(1 row)

next_day(x,y)

描述：用于计算x时间开始的下一个星期y的时间。

ORA和TD兼容模式下，返回值类型为timestamp。
MySQL兼容模式下，返回值类型为date。

示例：

     
          select next_day(TIMESTAMP '2017-05-25 00:00:00','Sunday')AS cal_result;
     cal_result      
---------------------
 2017-05-28 00:00:00
(1 row)

to_days(timestamp)

描述：返回自0年开始到入参日期的天数。

返回值类型：int

示例：

     
          SELECT to_days(TIMESTAMP '2008-10-07');
 to_days
---------
  733687
(1 row)

EXTRACT

EXTRACT(field FROM source)

extract函数从日期或时间的数值里抽取子域，比如年、小时等。source必须是一个timestamp、time或interval类型的值表达式（类型为date的表达式转换为timestamp，因此也可以用）。field是一个标识符或者字符串，它指定从源数据中抽取的域。extract函数返回类型为double precision的数值。field的取值范围如下所示。

century

世纪。

第一个世纪从0001-01-01 00:00:00 AD开始。这个定义适用于所有使用阳历的国家。没有0世纪，直接从公元前1世纪到公元1世纪。

示例：

      
           SELECT EXTRACT(century FROM TIMESTAMP '2000-12-16 12:21:13');
 date_part 
-----------
        20
(1 row)

day

如果source为timestamp，表示月份里的日期（1-31）。

        
             SELECT EXTRACT(DAY FROM TIMESTAMP '2001-02-16 20:38:40');
 date_part 
-----------
        16
(1 row)

如果source为interval，表示天数。

        
             SELECT EXTRACT(DAY FROM interval '40 days 1 minute');
 date_part 
-----------
        40
(1 row)

decade

年份除以10。

      
           SELECT EXTRACT(decade FROM TIMESTAMP '2001-02-16 20:38:40');
 date_part 
-----------
       200
(1 row)

dow

每周的星期几，星期天（0）到星期六（6）。

      
           SELECT EXTRACT(dow FROM TIMESTAMP '2001-02-16 20:38:40');
 date_part 
-----------
         5
(1 row)

doy

一年的第几天（1~365/366）。

      
           SELECT EXTRACT(doy FROM TIMESTAMP '2001-02-16 20:38:40');
 date_part 
-----------
        47
(1 row)

epoch

如果source为timestamp with time zone，表示自1970-01-01 00:00:00-00 UTC以来的秒数（结果可能是负数）；

如果source为date和timestamp，表示自1970-01-01 00:00:00-00当地时间以来的秒数；

如果source为interval，表示时间间隔的总秒数。

        
             SELECT EXTRACT(epoch FROM TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40.12-08');
  date_part   
--------------
 982384720.12
(1 row)

        
             SELECT EXTRACT(epoch FROM interval '5 days 3 hours');
 date_part 
-----------
    442800
(1 row)

将epoch值转换为时间戳的方法。

        
             SELECT TIMESTAMP WITH TIME ZONE 'epoch' + 982384720.12 * interval '1 second' AS RESULT;
          result          
---------------------------
 2001-02-17 12:38:40.12+08
(1 row)

hour

小时域（0-23）。

      
           SELECT EXTRACT(hour FROM TIMESTAMP '2001-02-16 20:38:40');
 date_part 
-----------
        20
(1 row)

isodow

一周的第几天（1-7）。

星期一为1，星期天为7。

除了星期天外，都与dow相同。

      
           SELECT EXTRACT(isodow FROM TIMESTAMP '2001-02-18 20:38:40');
 date_part 
-----------
         7
(1 row)

isoyear

日期中的ISO 8601标准年（不适用于间隔）。

每个带有星期一开始的周中包含1月4日的ISO年，所以在年初的1月或12月下旬的ISO年可能会不同于阳历的年。详细信息请参见后续的 week描述。

      
           SELECT EXTRACT(isoyear FROM DATE '2006-01-01');
 date_part 
-----------
      2005
(1 row)

      
           SELECT EXTRACT(isoyear FROM DATE '2006-01-02');
 date_part 
-----------
      2006
(1 row)

microseconds

秒域（包括小数部分）乘以1,000,000。

      
           SELECT EXTRACT(microseconds FROM TIME '17:12:28.5');
 date_part 
-----------
  28500000
(1 row)

millennium

千年。

20世纪（19xx年）里面的年份在第二个千年里。第三个千年从2001年1月1日零时开始。

      
           SELECT EXTRACT(millennium FROM TIMESTAMP '2001-02-16 20:38:40');
 date_part 
-----------
         3
(1 row)

milliseconds

秒域（包括小数部分）乘以1000。请注意它包括完整的秒。

      
           SELECT EXTRACT(milliseconds FROM TIME '17:12:28.5');
 date_part 
-----------
     28500
(1 row)

minute

分钟域（0-59）。

      
           SELECT EXTRACT(MINUTE FROM TIMESTAMP '2001-02-16 20:38:40');
 date_part 
-----------
        38
(1 row)

month

如果source为timestamp，表示一年里的月份数（1-12）。

      
           SELECT EXTRACT(MONTH FROM TIMESTAMP '2001-02-16 20:38:40');
 date_part 
-----------
         2
(1 row)

如果source为interval，表示月的数目，然后对12取模（0-11）。

      
           SELECT EXTRACT(MONTH FROM interval '2 years 13 months');
 date_part 
-----------
         1
(1 row)

quarter

该天所在的该年的季度（1-4）。

      
           SELECT EXTRACT(quarter FROM TIMESTAMP '2001-02-16 20:38:40');
 date_part 
-----------
         1
(1 row)

second

秒域，包括小数部分（0-59）。

      
           SELECT EXTRACT(SECOND FROM TIME '17:12:28.5');
 date_part 
-----------
      28.5
(1 row)

timezone

与UTC的时区偏移量，单位为秒。正数对应UTC东边的时区，负数对应UTC西边的时区。

      
           SELECT EXTRACT(timezone FROM TIMETZ '17:12:28');
 date_part
-----------
    -36000
(1 row)

timezone_hour

时区偏移量的小时部分。

      
           SELECT EXTRACT(timezone_hour FROM TIMETZ '17:12:28');
 date_part
-----------
       -10
(1 row)

timezone_minute

时区偏移量的分钟部分。

      
           SELECT EXTRACT(timezone_minute FROM TIMETZ '17:12:28');
 date_part
-----------
         0
(1 row)

week

该天在所在的年份里是第几周。ISO 8601定义一年的第一周包含该年的一月四日（ISO-8601 的周从星期一开始）。换句话说，一年的第一个星期四在第一周。

在ISO定义里，一月的头几天可能是前一年的第52或者第53周，十二月的后几天可能是下一年第一周。比如，2005-01-01是2004年的第53周，而2006-01-01是2005年的第52周，2012-12-31是2013年的第一周。建议isoyear字段和week一起使用以得到一致的结果。

      
           SELECT EXTRACT(week FROM TIMESTAMP '2001-02-16 20:38:40');
 date_part 
-----------
         7
(1 row)

year

年份域。

      
           SELECT EXTRACT(YEAR FROM TIMESTAMP '2001-02-16 20:38:40');
 date_part 
-----------
      2001
(1 row)

date_part

date_part函数是在传统的Ingres函数的基础上制作的（该函数等效于SQL标准函数extract）：

date_part('field', source)

这里的field参数必须是一个字符串，而不是一个名字。有效的field与extract一样，详细信息请参见EXTRACT。

示例：

    
         SELECT date_part('day', TIMESTAMP '2001-02-16 20:38:40');
 date_part 
-----------
        16
(1 row)

    
         SELECT date_part('hour', interval '4 hours 3 minutes');
 date_part 
-----------
         4
(1 row)

date_format

date_format(timestamp, fmt)

date_format函数将日期参数按照fmt指定的格式转换为字符串。

示例：

    
         SELECT date_format('2009-10-04 22:23:00', '%M %D %W');
    date_format
--------------------
 October 4th Sunday
(1 row)
SELECT date_format('2021-02-20 08:30:45', '%Y-%m-%d %H:%i:%S');
     date_format
---------------------
 2021-02-20 08:30:45
(1 row)
SELECT date_format('2021-02-20 18:10:15', '%r-%T');
     date_format
----------------------
 06:10:15 PM-18:10:15
(1 row)

表 date_format支持的输出格式显示了可以用于将日期参数格式化输出的格式类型，这些格式类型适用于函数date_format、time_format、str_to_date、str_to_time和from_unixtime。

表2 date_format支持的输出格式
格式	说明	取值
%a	缩写星期名	Sun...Sat
%b	缩写月份名	Jan...Dec
%c	月份	0...12
%D	带英文后缀的月份日期	0th, 1st, 2nd, 3rd, …
%d	一个月里的日，2位	00...31
%e	一个月里的日	0...31
%f	微秒	000000...999999
%H	小时，24小时制	00...23
%h	小时，12小时制	01...12
%I	小时，12小时制，同%h	01...12
%i	分钟	00...59
%j	一年里的日	001...366
%k	小时，24小时制，同%H	0...23
%l	小时，12小时制，同%h	1...12
%M	月份名	January...December
%m	月份，两位	00...12
%p	上下午	AM PM
%r	时间，12小时制	hh::mm::ss AM/PM
%S	秒	00...59
%s	秒，同%S	00...59
%T	时间，24小时制	hh::mm::ss
%U	周 (00-53) 星期日是一周的第一天	00...53
%u	周 (00-53) 星期一是一周的第一天	00...53
%V	周 (01-53) 星期日是一周的第一天，与%X搭配使用	01...53
%v	周 (01-53) 星期一是一周的第一天，与%x搭配使用	01...53
%W	星期名	Sunday...Saturday
%w	一周的日，周日为0	0...6
%X	年份，其中的星期日是周的第一天，4 位，与%V搭配使用	-
%x	年份，其中的星期一是周的第一天，4 位，与%v搭配使用	-
%Y	年份，4位	-
%y	年份，2位	-
%%	字符'%'	字符'%'
%x	'x'，上述未列出的任意字符	字符'x'

date_format支持的输出格式中，%U、%u、%V、%v、%X、%x暂不支持。

父主题： 函数和操作符

上一篇：数字操作函数和操作符

下一篇：类型转换函数

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消