|
|
相关文章推荐
要尽量避免在查询中使用 'now'::date、'now'::timestamp、'now'::timestamptz字符串常量强转以及text_date('now')的类似表达式来获取数据库当前时间或者将当前时间值作为函数入参场景，在这些场景下，优化器会提前算出常量时间，造成查询结果不正确。
gaussdb=# EXPLAIN SELECT * FROM t1 WHERE b='now'::date;
QUERY PLAN
-----------------------------------------------------
Seq Scan on t1 (cost=0.00..13.60 rows=1 width=310)
Filter: ((b)::text = '2024-11-09 15:07:56'::text)
(2 rows)
gaussdb=# EXPLAIN SELECT * FROM t1 WHERE b=text_date('now');
QUERY PLAN
-----------------------------------------------------
Seq Scan on t1 (cost=0.00..13.60 rows=1 width=310)
Filter: ((b)::text = '2024-11-09'::text)
(2 rows)
推荐使用now()、currenttimestamp()函数作为获取数据库当前时间的方法。
gaussdb=# EXPLAIN SELECT * FROM t1 WHERE b=now(); QUERY PLAN ----------------------------------------------------- Seq Scan on t1 (cost=0.00..14.80 rows=1 width=310) Filter: ((b)::text = (now())::text) (2 rows) gaussdb=# EXPLAIN SELECT * FROM t1 WHERE b=text_date(now()); QUERY PLAN ---------------------------------------------------------- Seq Scan on t1 (cost=0.00..16.00 rows=1 width=310) Filter: ((b)::text = (text_date((now())::text))::text) (2 rows)
用户在使用时间和日期操作符时，对应的操作数请使用明确的类型前缀修饰，以确保数据库在解析操作数的时候能够与用户预期一致，不会产生用户非预期的结果。
比如下面示例没有明确数据类型就会出现异常错误。
gaussdb=# SELECT date '2001-09-28' + interval '1 hour' AS RESULT;
result
---------------------
2001-09-28 01:00:00
(1 row)
gaussdb=# SELECT date '2001-09-28' + time '03:00' AS RESULT;
result
---------------------
2001-09-28 03:00:00
(1 row)
gaussdb=# SELECT interval '1 day' + interval '1 hour' AS RESULT;
result
----------------
1 day 01:00:00
(1 row)
gaussdb=# SELECT timestamp '2001-09-28 01:00' + interval '23 hours' AS RESULT;
result
---------------------
2001-09-29 00:00:00
(1 row)
gaussdb=# SELECT date '2001-10-01' - date '2001-09-28' AS RESULT;
result
--------
(1 row)
gaussdb=# SELECT date '2001-10-01' - integer '7' AS RESULT;
result
---------------------
2001-09-24 00:00:00
(1 row)
gaussdb=# SELECT date '2001-09-28' - interval '1 hour' AS RESULT;
result
---------------------
2001-09-27 23:00:00
(1 row)
gaussdb=# SELECT timestamp '2001-09-28 23:00' - interval '23 hours' AS RESULT;
result
---------------------
2001-09-28 00:00:00
(1 row)
gaussdb=# SELECT interval '1 day' - interval '1 hour' AS RESULT;
result
----------
23:00:00
(1 row)
gaussdb=# SELECT timestamp '2001-09-29 03:00' - timestamp '2001-09-27 12:00' AS RESULT;
result
----------------
1 day 15:00:00
(1 row)
gaussdb=# SELECT double precision '3.5' * interval '1 hour' AS RESULT;
result
----------
03:30:00
(1 row)
gaussdb=# SELECT interval '1 hour' / double precision '1.5' AS RESULT;
result
----------
00:40:00
(1 row)
age(timestamp, timestamp)
描述：将两个参数相减，并以年、月、日作为返回值。若相减值为负，则函数返回亦为负，入参可以都带timezone或都不带timezone。
返回值类型：interval
gaussdb=# SELECT age(timestamp '2001-04-10', timestamp '1957-06-13');
-------------------------
43 years 9 mons 27 days
(1 row)
clock_timestamp()
描述：返回当前函数被调用时的系统时间的时间戳。volatile函数，每次扫描都会取最新的时间戳，因此在一次查询中每次调用结果不相同。
返回值类型：timestamp with time zone
current_timestamp
描述：返回的结果为当前SQL启动的系统时间。语句级别时间，同一个语句内返回结果不变。
返回值类型：timestamp with time zone
current_timestamp(precision)
描述：返回的结果为当前事务启动的系统时间，并将结果的微秒圆整为指定小数位。
返回值类型：timestamp with time zone
此函数在ORA兼容模式数据库中且参数a_format_version值为10c和a_format_dev_version值为s2的情况下，precision参数支持numeric类型的整值，否则仅支持int输入。
微秒末位的0不显示，如2017-09-01 10:32:19.212000输出显示为2017-09-01 10:32:19.212。
pg_systimestamp()
返回值类型：timestamp with time zone
获取日期或者时间值中子域的值，例如年或者小时的值。
等效于extract(field from timestamp)。
timestamp类型：abstime、date、interval、reltime、time with time zone、time without time zone、timestamp with time zone、timestamp without time zone。
返回值类型：double precision
gaussdb=# SELECT date_part('hour', timestamp '2001-02-16 20:38:40');
date_part
-----------
(1 row)
date_part(text, interval)
描述：获取月份的值。如果大于12，则取与12的模。等效于extract(field from timestamp)。
返回值类型：double precision
gaussdb=# SELECT date_part('month', interval '2 years 3 months');
date_part
-----------
(1 row)
date_trunc(text, timestamp)
返回值类型：interval、timestamp with time zone、timestamp without time zone
gaussdb=# SELECT date_trunc('hour', timestamp '2001-02-16 20:38:40');
date_trunc
---------------------
2001-02-16 20:00:00
(1 row)
gaussdb=# SELECT trunc(timestamp '2001-02-16 20:38:40'); trunc
---------------------
2001-02-16 00:00:00
(1 row)
gaussdb=# SELECT trunc(timestamp '2001-02-16 20:38:40', 'hour'); trunc
---------------------
2001-02-16 20:00:00
(1 row)
gaussdb=# SELECT round(timestamp '2001-02-16 20:38:40', 'hour'); round
---------------------
2001-02-16 21:00:00
(1 row)
gaussdb=# select daterange('2000-05-06','2000-08-08');
daterange
-------------------------
[2000-05-06,2000-08-08)
(1 row)
gaussdb=# select daterange('2000-05-06','2000-08-08','[]');
daterange
-------------------------
[2000-05-06,2000-08-09)
(1 row)
gaussdb=# SELECT extract(hour from timestamp '2001-02-16 20:38:40');
date_part
-----------
(1 row)
gaussdb=# SELECT extract(month from interval '2 years 3 months');
date_part
-----------
(1 row)
gaussdb=# SELECT JUSTIFY_INTERVAL(INTERVAL '1 MON -1 HOUR');
justify_interval
------------------
29 days 23:00:00
(1 row)
numtodsinterval(num, interval_unit)
描述：将数字转换为interval类型。num为numeric类型数字，interval_unit为固定格式字符串（'DAY' | 'HOUR' | 'MINUTE' | 'SECOND'）。
可以通过设置GUC参数IntervalStyle为ORA，兼容该函数interval输出格式。
返回值类型：interval
gaussdb=# SET intervalstyle = oracle;
gaussdb=# SELECT numtodsinterval(100, 'HOUR');
numtodsinterval
-------------------------------
+000000004 04:00:00.000000000
(1 row)
此函数在ORA兼容模式数据库中且参数a_format_version值为10c和a_format_dev_version值为s2的情况下：当参数interval_unit为 'DAY' 时，参数num超过1000000000会报错。
numtoyminterval(num, interval_unit)
描述：将数字转换为interval类型。num为numeric类型数字，interval_unit为固定格式字符串（'YEAR' | 'MONTH'）。
可以通过设置GUC参数IntervalStyle为ORA，兼容interval输出格式。
返回值类型：interval
gaussdb=# \c gaussdb_o;
Non-SSL connection (SSL connection is recommended when requiring high-security)
You
are now connected to database "gaussdb_o" as user "omm".
gaussdb_o=# set a_format_version='10c';
gaussdb_o=# set a_format_dev_version='s2';
gaussdb=# SELECT numtoyminterval(100, 'MONTH');
numtoyminterval
-----------------
8 years 4 mons
(1 row)
gaussdb_o=# SET intervalstyle = oracle;
gaussdb_o=# SELECT numtoyminterval(100, 'MONTH');
numtoyminterval
-----------------
8-4
(1 row)
gaussdb_o=# \c postgres
Non-SSL connection (SSL connection is recommended when requiring high-security)
You are now connected to database "postgres" as user "omm".
gaussdb=# DROP DATABASE gaussdb_o;
DROP DATABASE
new_time(date, timezone1,timezone2)
描述：当timezone1所表示时区的日期时间为date的时候，返回此时timezone2所表示时区的日期时间值。
返回值类型：timestamp
gaussdb=# select new_time('1997-10-10','AST','EST');
new_time
---------------------
1997-10-09 23:00:00
(1 row)
gaussdb=# SELECT NEW_TIME(TO_TIMESTAMP ('10-Sep-02 14:10:10.123000','DD-Mon-RR HH24:MI:SS.FF'), 'AST', 'PST');
new_time
-------------------------
2002-09-10 10:10:10.123
(1 row)
此函数在ORA兼容模式数据库中且参数a_format_version值为10c和a_format_dev_version值为s2的情况下生效。
当set session time zone的值为GMT+08:00/GMT-08:00格式时，正值的偏移量被用于格林威治以西的位置，例如GMT+08:00表示西八区，GMT-08:00表示东八区。
sys_extract_utc(timestamp| timestamptz)
描述：从具有时区偏移量或时区区域名称的日期时间值中提取UTC（协调世界时-以前称为格林威治平均时间）。如果未指定时区，则日期时间与会话时区关联。入参有timestmp和timestamp两种形式。
返回值类型：timestamp。
gaussdb=# SELECT SYS_EXTRACT_UTC(TIMESTAMP '2000-03-28 11:30:00.00');
sys_extract_utc
---------------------
2000-03-28 03:30:00
(1 row)
gaussdb=# SELECT SYS_EXTRACT_UTC(TIMESTAMPTZ '2000-03-28 11:30:00.00 -08:00');
sys_extract_utc
---------------------
2000-03-28 19:30:00
(1 row)
tz_offset('time_zone_name' | '(+/-)hh:mi' | SESSIONTIMEZONE | DBTIMEZONE)
描述：入参有以上四种形式，返回入参所表示时区的UTC偏移量。
返回值类型：text。
pg_sleep(seconds)
描述：服务器线程延迟时间，单位为秒。注意，当数据库调用该函数时，会获取相应的事务快照，相当于一个长事务，如果入参时间过长可能导致数据库oldestxmin无法推进，影响表的回收和查询性能。
返回值类型：void
gaussdb=# SELECT statement_timestamp();
statement_timestamp
-------------------------------
2017-09-01 17:04:39.119267+08
(1 row)
timeofday
-------------------------------------
Fri Sep 01 17:05:01.167506 2017 CST
(1 row)
gaussdb=# SELECT transaction_timestamp();
transaction_timestamp
-------------------------------
2017-09-01 17:05:13.534454+08
(1 row)
d：timestamp类型的值，以及可以隐式转换为timestamp类型的值。
n：INTEGER类型的值，以及可以隐式转换为INTEGER类型的值。
返回值类型：timestamp
gaussdb=# SELECT add_months(to_date('2017-5-29', 'yyyy-mm-dd'), 11) FROM sys_dummy;
add_months
---------------------
2018-04-29 00:00:00
(1 row)
gaussdb=# SELECT last_day(to_date('2017-01-01', 'YYYY-MM-DD')) AS cal_result;
cal_result
---------------------
2017-01-31 00:00:00
(1 row)
months_between(d1, d2)
描述：用于计算时间点d1和时间点d2的月份差值，如果两个日期都是月末或天数相同，则返回整数，否则返回值带小数，按31天/月计算。
返回值类型：numeric
gaussdb=#
SELECT months_between(to_date('2022-10-31', 'yyyy-mm-dd'), to_date('2022-09-30', 'yyyy-mm-dd'));
months_between
----------------
(1 row)
gaussdb=# SELECT months_between(to_date('2022-10-30', 'yyyy-mm-dd'), to_date('2022-09-30', 'yyyy-mm-dd'));
months_between
----------------
(1 row)
gaussdb=# SELECT months_between(to_date('2022-10-29', 'yyyy-mm-dd'), to_date('2022-09-30', 'yyyy-mm-dd'));
months_between
-----------------------
.96774193548387096774
(1 row)
此函数在ORA兼容模式数据库中且参数a_format_version值为10c和a_format_dev_version值为s1的情况下有效。
next_day(x,y)
返回值类型：timestamp
gaussdb=# SELECT next_day(timestamp '2017-05-25 00:00:00','Sunday')AS cal_result;
cal_result
---------------------
2017-05-28 00:00:00
(1 row)
gaussdb=# call tinterval(abstime 'May 10, 1947 23:59:12', abstime 'Mon May 1 00:30:30 1995');
tinterval
-----------------------------------------------------
["1947-05-10 23:59:12+08" "1995-05-01 00:30:30+08"]
(1 row)
gaussdb=# SELECT tintervalend('["Sep 4, 1983 23:59:12" "Oct4, 1983 23:59:12"]');
tintervalend
------------------------
1983-10-04 23:59:12+08
(1 row)
gaussdb=# SELECT tintervalrel('["Sep 4, 1983 23:59:12" "Oct4, 1983 23:59:12"]');
tintervalrel
--------------
1 mon
(1 row)
transaction_timestamp()
now()
其中CURRENT_TIME和CURRENT_TIMESTAMP(precision)传递带有时区的值；LOCALTIME和LOCALTIMESTAMP传递的值不带时区。CURRENT_TIME、LOCALTIME和LOCALTIMESTAMP可以指定精度参数，这会导致结果在秒字段中四舍五入到小数位数。如果没有精度参数，结果将被给予所能得到的全部精度。
因为这些函数全部都按照当前事务的开始时刻返回结果，所以它们的值在事务运行的整个期间内都不改变。我们认为这是一个特性：目的是为了允许一个事务在“当前”时间上有一致的概念，这样在同一个事务里的多个修改可以保持同样的时间戳。
其中transaction_timestamp()等价于CURRENT_TIMESTAMP(precision)，表示当前语句所在事务的开启时间。now()等效于transaction_timestamp()。
以下接口返回当前语句开始时间：
statement_timestamp()
statement_timestamp()返回当前语句的开始时刻（更准确的说是收到客户端最后一条命令的时间）。statement_timestamp()和transaction_timestamp()在一个事务的第一条命令期间返回值相同，但是在随后的命令中却不一定相同。
以下接口返回函数被调用时的真实当前时间：
clock_timestamp()
timeofday()
clock_timestamp()返回真正的当前时间，因此它的值甚至在同一条SQL 命令中都会变化。timeofday()和clock_timestamp()相似，timeofday()也返回真实的当前时间，但是它的结果是一个格式化的text串，而不是timestamp with time zone值。
gaussdb=# SELECT timestamp_diff('year','2018-01-01','2020-04-01');
timestamp_diff
----------------
(1 row)
gaussdb=# SELECT timestamp_diff('month','2018-01-01','2020-04-01');
timestamp_diff
----------------
(1 row)
gaussdb=# SELECT timestamp_diff('quarter','2018-01-01','2020-04-01');
timestamp_diff
----------------
(1 row)
gaussdb=# SELECT timestamp_diff('week','2018-01-01','2020-04-01');
timestamp_diff
----------------
(1 row)
gaussdb=# SELECT timestamp_diff('day','2018-01-01','2020-04-01');
timestamp_diff
----------------
(1 row)
gaussdb=# SELECT timestamp_diff('hour','2018-01-01 10:10:10','2018-01-01 12:12:12');
timestamp_diff
----------------
(1 row)
gaussdb=# SELECT timestamp_diff('minute','2018-01-01 10:10:10','2018-01-01 12:12:12');
timestamp_diff
----------------
(1 row)
gaussdb=# SELECT timestamp_diff('second','2018-01-01 10:10:10','2018-01-01 10:12:12');
timestamp_diff
----------------
(1 row)
gaussdb=# SELECT timestamp_diff('microsecond','2018-01-01 10:10:10','2018-01-01 10:12:12');
timestamp_diff
----------------
122000000
(1 row)
TIMESTAMPDIFF(unit , timestamp_expr1, timestamp_expr2)
timestampdiff函数是计算两个日期时间之间(timestamp_expr2-timestamp_expr1)的差值，并以unit形式范围结果。timestamp_expr1，timestamp_expr2必须是一个timestamp、timestamptz、date类型的值表达式。unit表示的是两个日期差的单位。
等效于timestamp_diff(text, timestamp, timestamp)。
该函数仅在GaussDB兼容MySQL类型时（即dbcompatibility = 'MYSQL'）有效，其他类型不支持该函数。
gaussdb=# SELECT TIMESTAMPDIFF(YEAR, '2018-01-01', '2020-01-01');
timestamp_diff
----------------
(1 row)
gaussdb=# SELECT TIMESTAMPDIFF(QUARTER, '2018-01-01', '2020-01-01');
timestamp_diff
----------------
(1 row)
gaussdb=# SELECT TIMESTAMPDIFF(MONTH, '2018-01-01', '2020-01-01');
timestamp_diff
----------------
(1 row)
gaussdb=# SELECT TIMESTAMPDIFF(WEEK, '2018-01-01', '2020-01-01');
timestamp_diff
----------------
(1 row)
gaussdb=# SELECT TIMESTAMPDIFF(DAY, '2018-01-01', '2020-01-01');
timestamp_diff
----------------
(1 row)
gaussdb=# SELECT TIMESTAMPDIFF(HOUR, '2020-01-01 10:10:10', '2020-01-01 11:11:11');
timestamp_diff
----------------
(1 row)
gaussdb
=# SELECT TIMESTAMPDIFF(MINUTE, '2020-01-01 10:10:10', '2020-01-01 11:11:11');
timestamp_diff
----------------
(1 row)
gaussdb=# SELECT TIMESTAMPDIFF(SECOND, '2020-01-01 10:10:10', '2020-01-01 11:11:11');
timestamp_diff
----------------
(1 row)
gaussdb=# SELECT TIMESTAMPDIFF(MICROSECOND, '2020-01-01 10:10:10.000000', '2020-01-01 10:10:10.111111');
timestamp_diff
----------------
111111
(1 row)
gaussdb=# SELECT TIMESTAMPDIFF(HOUR,'2020-05-01 10:10:10-01','2020-05-01 10:10:10-03');
timestamp_diff
----------------
(1 row)
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世纪。
gaussdb=# SELECT EXTRACT(CENTURY FROM TIMESTAMP '2000-12-16 12:21:13');
date_part
-----------
(1 row)
gaussdb=# SELECT EXTRACT(DAY FROM TIMESTAMP '2001-02-16 20:38:40');
date_part
-----------
(1 row)
gaussdb=# SELECT EXTRACT(DAY FROM INTERVAL '40 days 1 minute');
date_part
-----------
(1 row)
gaussdb=# SELECT EXTRACT(DECADE FROM TIMESTAMP '2001-02-16 20:38:40');
date_part
-----------
(1 row)
gaussdb=# SELECT EXTRACT(DOW FROM TIMESTAMP '2001-02-16 20:38:40');
date_part
-----------
(1 row)
gaussdb=# SELECT EXTRACT(DOY FROM TIMESTAMP '2001-02-16 20:38:40');
date_part
-----------
(1 row)
如果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，表示时间间隔的总秒数。
gaussdb=# SELECT EXTRACT(EPOCH FROM TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40.12-08');
date_part
--------------
982384720.12
(1 row)
gaussdb=# SELECT EXTRACT(EPOCH FROM INTERVAL '5 days 3 hours');
date_part
-----------
442800
(1 row)
gaussdb=# SELECT TIMESTAMP WITH TIME ZONE 'epoch' + 982384720.12 * INTERVAL '1 second' AS RESULT;
result
---------------------------
2001-02-17 12:38:40.12+08
(1 row)
gaussdb=# SELECT EXTRACT(HOUR FROM TIMESTAMP '2001-02-16 20:38:40');
date_part
-----------
(1 row)
gaussdb=# SELECT EXTRACT(ISODOW FROM TIMESTAMP '2001-02-18 20:38:40');
date_part
-----------
(1 row)
(1 row)
gaussdb=# SELECT EXTRACT(WEEK FROM TIMESTAMP '2006-01-01 00:00:40');
date_part
-----------
(1 row)
(1 row)
gaussdb=# SELECT EXTRACT(WEEK FROM TIMESTAMP '2006-01-02 00:00:40');
date_part
-----------
(1 row)
gaussdb=# SELECT EXTRACT(MICROSECONDS FROM TIME '17:12:28.5');
date_part
-----------
28500000
(1 row)
gaussdb=# SELECT EXTRACT(MILLENNIUM FROM TIMESTAMP '2001-02-16 20:38:40');
date_part
-----------
(1 row)
gaussdb=# SELECT EXTRACT(MILLISECONDS FROM TIME '17:12:28.5');
date_part
-----------
28500
(1 row)
gaussdb=# SELECT EXTRACT(MINUTE FROM TIMESTAMP '2001-02-16 20:38:40');
date_part
-----------
(1 row)
gaussdb=# SELECT EXTRACT(MONTH FROM TIMESTAMP '2001-02-16 20:38:40');
date_part
-----------
(1 row)
gaussdb=# SELECT EXTRACT(MONTH FROM INTERVAL '2 years 13 months');
date_part
-----------
(1 row)
gaussdb=# SELECT EXTRACT(QUARTER FROM TIMESTAMP '2001-02-16 20:38:40');
date_part
-----------
(1 row)
该天在所在的年份里是第几周。ISO 8601定义一年的第一周包含该年的一月四日（ISO-8601 的周从星期一开始）。换句话说，一年的第一个星期四在第一周。
在ISO定义里，一月的头几天可能是前一年的第52或者第53周，十二月的后几天可能是下一年第一周。比如，2006-01-01是2005年的第52周，而2006-01-02是2006年的第1周。建议isoyear字段和week一起使用以得到一致的结果。
(1 row)
gaussdb=# SELECT EXTRACT(WEEK FROM TIMESTAMP '2006-01-01 00:00:40');
date_part
-----------
(1 row)
gaussdb=# SELECT EXTRACT(YEAR FROM TIMESTAMP '2001-02-16 20:38:40');
date_part
-----------
(1 row)
date_part
date_part函数是在传统的Ingres函数的基础上制作的（该函数等效于SQL标准函数extract）：
date_part('field', source)
这里的field参数必须是一个字符串，而不是一个名称。有效的field与extract一样，详细信息请参见EXTRACT。
gaussdb=# SELECT date_part('day', TIMESTAMP '2001-02-16 20:38:40');
date_part
-----------
(1 row)
gaussdb=# SELECT date_part('hour', INTERVAL '4 hours 3 minutes');
date_part
-----------
(1 row)
输入的两位年份在00~49之间：
当前年份的后两位在00~49之间，返回值年份的前两位和当前年份的前两位相同。
当前年份的后两位在50~99之间，返回值年份的前两位是当前年份的前两位加1。
输入的两位年份在50~99之间：
当前年份的后两位在00~49之间，返回值年份的前两位是当前年份的前两位减1。
当前年份的后两位在50~99之间，返回值年份的前两位和当前年份的前两位相同。
此函数在ORA兼容模式数据库中且参数a_format_version值为10c和a_format_dev_version值为s1的情况下：
to_date, to_timestamp函数支持FX模式（输入和模式严格对应），支持X模式（小数点）。
输入模式不能出现超过一次，表示相同信息的模式不能同时出现。如SYYYY和BC不能同时出现。
模式大小写不敏感。
建议输入和模式之间使用分隔符，否则不保证行为与O完全一致。
推荐文章