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

时间日期操作符

用户在使用时间和日期操作符时，对应的操作数请使用明确的类型前缀修饰，以确保数据库在解析操作数的时候能够与用户预期一致，不会产生用户非预期的结果。比如下面示例没有明确数据类型就会出现异常错误。
SELECT date '2001-10-01' - '7' AS RESULT;

表12-27 时间和日期操作符

操作符	示例
+	`vastbase=# SELECT date '2001-09-28' + integer '7' AS RESULT; result ——————— 2001-10-05 00:00:00 (1 row)`
	`vastbase=# SELECT date '2001-09-28' + interval '1 hour' AS RESULT; result ——————— 2001-09-28 01:00:00 (1 row)`
	`vastbase=# SELECT date '2001-09-28' + time '03:00' AS RESULT; result ——————— 2001-09-28 03:00:00 (1 row)`
	`vastbase=# SELECT interval '1 day' + interval '1 hour' AS RESULT; result —————- 1 day 01:00:00 (1 row)`
	`vastbase=# SELECT timestamp '2001-09-28 01:00' + interval '23 hours' AS RESULT; result ——————— 2001-09-29 00:00:00 (1 row)`
	`vastbase=# SELECT time '01:00' + interval '3 hours' AS RESULT; result ———- 04:00:00 (1 row)`
-	`vastbase=# SELECT date '2001-10-01' - date '2001-09-28' AS RESULT; result ——– 3 days (1 row)`
	`vastbase=# SELECT date '2001-10-01' - integer '7' AS RESULT; result ——————— 2001-09-24 00:00:00 (1 row)`
	`vastbase=# SELECT date '2001-09-28' - interval '1 hour' AS RESULT; result ——————— 2001-09-27 23:00:00 (1 row)`
	`vastbase=# SELECT time '05:00' - time '03:00' AS RESULT; result ———- 02:00:00 (1 row)`
	`vastbase=# SELECT time '05:00' - interval '2 hours' AS RESULT; result ———- 03:00:00 (1 row)`
	`vastbase=# SELECT timestamp '2001-09-28 23:00' - interval '23 hours' AS RESULT; result ——————— 2001-09-28 00:00:00 (1 row)`
	`vastbase=# SELECT interval '1 day' - interval '1 hour' AS RESULT; result ———- 23:00:00 (1 row)`
	`vastbase=# SELECT timestamp '2001-09-29 03:00' - timestamp '2001-09-27 12:00' AS RESULT; result —————- 1 day 15:00:00 (1 row)`
*	`vastbase=# SELECT 900 * interval '1 second' AS RESULT; result ———- 00:15:00 (1 row)`
	`vastbase=# SELECT 21 * interval '1 day' AS RESULT; result ——— 21 days (1 row)`
	`vastbase=# SELECT double precision '3.5' * interval '1 hour' AS RESULT; result ———- 03:30:00 (1 row)`
/	`vastbase=# SELECT interval '1 hour' / double precision '1.5' AS RESULT; result ———- 00:40:00 (1 row)`

时间/日期函数

age(timestamp, timestamp)

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

返回值类型：interval

示例：
```
vastbase=# SELECT age(timestamp '2001-04-10', timestamp '1957-06-13'); 
       age            
------------------------- 
43 years 9 mons 27 days 
(1 row)
```

age(timestamp)

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

返回值类型：interval

示例：

vastbase=# SELECT age(timestamp '1957-06-13'); 
       age            
------------------------- 
60 years 2 mons 18 days 
(1 row)

clock_timestamp()

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

返回值类型：timestamp with time zone

示例：

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

current_date

描述：当前日期。

返回值类型：date

示例：

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

current_time

描述：当前时间。

返回值类型：time with time zone

示例：

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

current_timestamp

描述：当前日期及时间。

返回值类型：timestamp with time zone

示例：

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

date_part(text, timestamp)

描述：

获取小时的值。

等效于extract(field from timestamp)。

返回值类型：double precision

示例：
```
vastbase=# 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 timestamp)。

返回值类型：double precision

示例：
```
vastbase=# SELECT date_part('month', interval '2 years 3 months'); 
date_part  
----------- 
     3 
(1 row)
```

date_trunc(text, timestamp)

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

返回值类型：timestamp

示例：

vastbase=# SELECT date_trunc('hour', timestamp  '2001-02-16 20:38:40'); 
 date_trunc       
--------------------- 
2001-02-16 20:00:00 
(1 row)

trunc(timestamp)

描述：默认按天截取。

示例：

vastbase=# SELECT trunc(timestamp  '2001-02-16 20:38:40');                                                                                                                                                                   trunc 
--------------------- 
2001-02-16 00:00:00 
(1 row)

extract(field from timestamp)

描述：获取小时的值。

返回值类型：double precision

示例：

vastbase=# SELECT extract(hour from timestamp '2001-02-16 20:38:40'); 
date_part  
----------- 
    20 
(1 row)

extract(field from interval)

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

返回值类型：double precision

示例：
```
vastbase=# SELECT extract(month from interval '2 years 3 months'); 
date_part  
----------- 
     3 
(1 row)
```
isfinite(date)

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

返回值类型：Boolean

示例：
```
vastbase=# SELECT isfinite(date '2001-02-16'); 
isfinite  
---------- 
t 
(1 row)
```
isfinite(timestamp)

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

返回值类型：Boolean

示例：
```
vastbase=# SELECT isfinite(timestamp '2001-02-16 21:28:30'); 
isfinite  
---------- 
t 
(1 row)
```
isfinite(interval)

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

返回值类型：Boolean

示例：
```
vastbase=# SELECT isfinite(interval '4 hours'); 
isfinite  
---------- 
t 
(1 row)
```
justify_days(interval)

描述：将时间间隔以月（30天为一月）为单位。

返回值类型：interval

示例：
```
vastbase=# SELECT justify_days(interval '35 days'); 
justify_days  
-------------- 
1 mon 5 days 
(1 row)
```
justify_hours(interval)

描述：将时间间隔以天（24小时为一天）为单位。

返回值类型：interval

示例：
```
vastbase=# SELECT JUSTIFY_HOURS(INTERVAL '27 HOURS'); 
justify_hours   
---------------- 
1 day 03:00:00 
(1 row)
```

justify_interval(interval)

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

返回值类型：interval

示例：

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

localtime

描述：当前时间。

返回值类型：time

示例：

vastbase=# SELECT localtime AS RESULT; 
 result 
---------------- 
16:05:55.664681 
(1 row)

localtimestamp

描述：当前日期及时间。

返回值类型：timestamp

示例：

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

now()

描述：当前日期及时间。

返回值类型：timestamp with time zone

示例：

vastbase=# 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为a，兼容该函数interval输出格式。

示例：

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

pg_sleep(seconds)

描述：服务器线程延迟时间，单位为秒。

返回值类型：void

示例：
```
vastbase=# SELECT pg_sleep(10); 
pg_sleep  
---------- 
 
(1 row)
```

statement_timestamp()

描述：当前日期及时间。

返回值类型：timestamp with time zone

示例：

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

sysdate

描述：当前日期及时间。

返回值类型：timestamp

示例：

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

timeofday()

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

返回值类型：text

示例：

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

transaction_timestamp()

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

返回值类型：timestamp with time zone

示例：

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

add_months(d,n)

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

返回值类型：timestamp

示例：

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

last_day(d)

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

返回值类型：timestamp

示例：

vastbase=# 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）的时间。

返回值类型：timestamp

示例：

vastbase=# select next_day(timestamp '2017-05-25 00:00:00','Sunday')AS cal_result; 
 cal_result       
--------------------- 
2017-05-28 00:00:00 
(1 row)

TIMESTAMPDIFF

TIMESTAMPDIFF(unit , timestamp_expr1, timestamp_expr2)

timestampdiff函数是计算两个日期时间之间(timestamp_expr2-timestamp_expr1)的差值，并以unit形式返回结果。timestamp_expr1，timestamp_expr2必须是一个timestamp、timestamptz、date类型的值表达式。unit表示的是两个日期差的单位。

该函数仅在Vastbase兼容MY类型时（即dbcompatibility ='B'）有效，其他类型不支持该函数。

year

年份。

vastbase=#  SELECT TIMESTAMPDIFF(YEAR, '2018-01-01', '2020-01-01'); 
timestamp_diff 
---------------- 
          2 
(1 row)

quarter

季度。

vastbase=#  SELECT TIMESTAMPDIFF(QUARTER, '2018-01-01', '2020-01-01'); 
timestamp_diff 
---------------- 
          8 
(1 row)

month

月份。

vastbase=#  SELECT TIMESTAMPDIFF(MONTH, '2018-01-01', '2020-01-01'); 
timestamp_diff 
---------------- 
         24 
(1 row)

week

星期。

vastbase=#  SELECT TIMESTAMPDIFF(WEEK, '2018-01-01', '2020-01-01'); 
timestamp_diff 
---------------- 
        104 
(1 row)

day

天。

vastbase=#  SELECT TIMESTAMPDIFF(DAY, '2018-01-01', '2020-01-01'); 
timestamp_diff 
---------------- 
        730 
(1 row)

hour

小时。

vastbase=#  SELECT TIMESTAMPDIFF(HOUR, '2020-01-01 10:10:10', '2020-01-01 11:11:11'); 
timestamp_diff 
---------------- 
          1 
(1 row)

minute

分钟。

vastbase=#  SELECT TIMESTAMPDIFF(MINUTE, '2020-01-01 10:10:10', '2020-01-01 11:11:11'); 
timestamp_diff 
---------------- 
         61 
(1 row)

second

秒。

vastbase=#  SELECT TIMESTAMPDIFF(SECOND, '2020-01-01 10:10:10', '2020-01-01 11:11:11'); 
timestamp_diff 
---------------- 
       3661 
(1 row)

microseconds

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

vastbase=#  SELECT TIMESTAMPDIFF(MICROSECOND, '2020-01-01 10:10:10.000000', '2020-01-01 10:10:10.111111'); 
timestamp_diff 
---------------- 
     111111 
(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世纪。

示例：
```
vastbase=# SELECT EXTRACT(CENTURY FROM TIMESTAMP '2000-12-16 12:21:13'); 
date_part  
----------- 
    20 
(1 row)
```

day

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

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

— 如果source为interval，表示天数。

vastbase=# SELECT EXTRACT(DAY FROM INTERVAL '40 days 1 minute'); 
date_part  
----------- 
    40 
(1 row)

decade

年份除以10。

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

dow

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

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

doy

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

vastbase=# 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，表示时间间隔的总秒数。

vastbase=# SELECT EXTRACT(EPOCH FROM TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40.12-08'); 
date_part    
-------------- 
982384720.12 
(1 row)
vastbase=# SELECT EXTRACT(EPOCH FROM INTERVAL '5 days 3 hours'); 
date_part  
----------- 
442800 
(1 row)

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

vastbase=# 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）。

vastbase=# SELECT EXTRACT(HOUR FROM TIMESTAMP '2001-02-16 20:38:40'); 
date_part  
----------- 
    20 
(1 row)

isodow

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

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

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

vastbase=# 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描述。
```
vastbase=# SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-01'); 
date_part  
----------- 
  2005 
(1 row)
vastbase=# SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-02'); 
date_part  
----------- 
  2006 
(1 row)
```

microseconds

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

vastbase=# SELECT EXTRACT(MICROSECONDS FROM TIME '17:12:28.5'); 
date_part  
----------- 
28500000 
(1 row)

millennium

千年。

20世纪（19xx年）里面的年份在第二个千年里。第三个千年从2001年1月1日零时开始。
```
vastbase=# SELECT EXTRACT(MILLENNIUM FROM TIMESTAMP '2001-02-16 20:38:40'); 
date_part  
----------- 
     3 
(1 row)
```

milliseconds

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

vastbase=# SELECT EXTRACT(MILLISECONDS FROM TIME '17:12:28.5'); 
date_part  
----------- 
 28500 
(1 row)

minute

分钟域（0-59）。

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

month

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

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

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

vastbase=# SELECT EXTRACT(MONTH FROM INTERVAL '2 years 13 months'); 
date_part  
----------- 
     1 
(1 row)

quarter

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

vastbase=# SELECT EXTRACT(QUARTER FROM TIMESTAMP '2001-02-16 20:38:40'); 
date_part  
----------- 
     1 
(1 row)

second

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

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

timezone

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

时区偏移量的小时部分。
timezone_minute

时区偏移量的分钟部分。
week

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

在ISO定义里，一月的头几天可能是前一年的第52或者第53周，十二月的后几天可能是下一年第一周。比如，2005-01-01是2004年的第53周，而2006-01-01是2005年的第52周，2012-12-31是2013年的第一周。建议isoyear字段和week一起使用以得到一致的结果。
```
vastbase=# SELECT EXTRACT(WEEK FROM TIMESTAMP '2001-02-16 20:38:40'); 
date_part  
----------- 
     7 
(1 row)
```

year

年份域。

vastbase=# 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。

示例：

vastbase=# SELECT date_part('day', TIMESTAMP '2001-02-16 20:38:40'); 
 date_part  
----------- 
        16 
(1 row)
vastbase=# SELECT date_part('hour', INTERVAL '4 hours 3 minutes'); 
 date_part  
----------- 
         4 
(1 row)

表12-28显示了可以用于格式化日期和时间值的模式。

表12-28 用于日期/时间格式化的模式

类别	模式	描述
小时	HH	一天的小时数（01-12）
	HH12	一天的小时数（01-12）
	HH24	一天的小时数（00-23）
分钟	MI	分钟（00-59）
秒	SS	秒（00-59）
	FF	微秒（000000-999999）
	SSSSS	午夜后的秒（0-86399）
上、下午	AM或A.M.	上午标识
上、下午	PM或P.M.	下午标识
年	Y,YYY	带逗号的年（4和更多位）
	SYYYY	公元前四位年
	YYYY	年（4和更多位）
	YYY	年的后三位
	YY	年的后两位
	Y	年的最后一位
	IYYY	ISO年（4位或更多位）
	IYY	ISO年的最后三位
	IY	ISO年的最后两位
	I	ISO年的最后一位
	RR	年的后两位（可在21世纪存储20世纪的年份）
	RRRR	可接收4位年或两位年。若是两位，则和RR的返回值相同，若是四位，则和YYYY相同。
	- BC或B.C. - AD或A.D.	纪元标识。BC（公元前），AD（公元后）。
月	MONTH	全长大写月份名（空白填充为9字符）
	MON	大写缩写月份名（3字符）
	MM	月份数（01-12）
	RM	罗马数字的月份（I-XII ；I=JAN）（大写）
天	DAY	全长大写日期名（空白填充为9字符）
	DY	缩写大写日期名（3字符）
	DDD	一年里的日（001-366）
	DD	一个月里的日（01-31）
	D	一周里的日（1-7 ；周日是 1）
周	W	一个月里的周数（1-5）（第一周从该月第一天开始）
	WW	一年里的周数（1-53）（第一周从该年的第一天开始）
	IW	ISO一年里的周数（第一个星期四在第一周里）
世纪	CC	世纪（2位）（21 世纪从 2001-01-01 开始）
儒略日	J	儒略日（自公元前 4712 年 1 月 1 日来的天数）
季度	Q	季度

上表中RR计算年的规则如下：

输入的两位年份在00~49之间：

当前年份的后两位在00~49之间，返回值年份的前两位和当前年份的前两位相同；

当前年份的后两位在50~99之间，返回值年份的前两位是当前年份的前两位加1。

输入的两位年份在50~99之间：

当前年份的后两位在00~49之间，返回值年份的前两位是当前年份的前两位减1；

当前年份的后两位在50~99之间，返回值年份的前两位和当前年份的前两位相同。

VastbaseG100

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

弹框头部