华为云用户手册

new_time(date, timezone1,timezone2) 描述：当timezone1所表示时区的日期时间为date时，返回此时timezone2所表示时区的日期时间值。 返回值类型：timestamp 示例： 1 2 3 4 5 6 7 8 9 10 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) 此函数在A兼容模式数据库中且参数a_format_version值为10c和a_format_dev_version值为s2的情况下生效。

sys_extract_utc(timestamp| timestamptz) 描述：从具有时区偏移量或时区区 域名 称的日期时间值中提取UTC（协调世界时-以前称为格林威治平均时间）。如果未指定时区，则日期时间与会话时区关联。入参有timestamp和timestamptz两种形式。 返回值类型：timestamp 示例： 1 2 3 4 5 6 7 8 9 10 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) 此函数在A兼容模式数据库中且参数a_format_version值为10c和a_format_dev_version值为s2的情况下有效。

sessiontimezone() 描述：当前会话的时区，无入参。 返回值类型：text 示例： 1 2 3 4 5 6 7 8 9 10 gaussdb=# SELECT SESSIONTIMEZONE; session_time_zone ------------------- PST8PDT (1 row) gaussdb=# SELECT LOWER(SESSIONTIMEZONE); lower ----------- @ 8 hours (1 row) 此函数在A兼容模式数据库中且参数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表示东八区。

numtodsinterval(num, interval_unit) 描述：将数字转换为interval类型。num为numeric类型数字，interval_unit为固定格式字符串（'DAY' | 'HOUR' | 'MINUTE' | 'SECOND'）。 可以通过设置GUC参数intervalstyle为a，兼容该函数interval输出格式。 返回值类型：interval 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 gaussdb=# SELECT numtodsinterval(100, 'HOUR'); numtodsinterval ----------------- 100:00:00 (1 row) gaussdb=# SET intervalstyle = a; SET gaussdb=# SELECT numtodsinterval(100, 'HOUR'); numtodsinterval ------------------------------- +000000004 04:00:00.000000000 (1 row) 此函数在参数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为a，兼容该函数interval输出格式。 返回值类型：interval 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 gaussdb=# SELECT numtoyminterval(100, 'MONTH'); numtoyminterval ----------------- 8 years 4 mons (1 row) gaussdb=# SET intervalstyle = a; SET gaussdb=# SELECT numtoyminterval(100, 'MONTH'); numtoyminterval ----------------- 8-4 (1 row) 此函数在A兼容模式数据库中且参数a_format_version值为10c和a_format_dev_version值为s2的情况下有效。

localtime 描述：当前事务的开始时刻的系统时间。在sql_compatibility = 'B'，且参数b_format_version值为5.7、b_format_dev_version值为s1时返回当前SQL语句执行开始时刻的系统日期和时间。 返回值类型：time，在sql_compatibility = 'B'，且参数b_format_version值为5.7、b_format_dev_version值为s1时返回类型timestamp without time zone。 示例： 1 2 3 4 5 6 7 8 9 10 11 12 gaussdb=# SELECT localtime AS RESULT; result ---------------- 16:05:55.664681 (1 row) -- B模式，打开兼容性参数后 gaussdb_m=# SELECT localtime; localtime --------------------- 2023-08-21 15:21:57 (1 row)

localtime([precision]) 描述：返回当前SQL语句执行开始时刻的系统日期和时间。 参数：表示精度（秒后小数位数），int类型，范围为[0,6]，缺省时默认值为0，无效值都报错。 返回值类型：timestamp without time zone 实现方式：注册系统函数的localtime。 示例： 1 2 3 4 5 6 7 8 9 10 gaussdb_m=# SELECT localtime(); localtime --------------------- 2023-08-21 15:23:49 (1 row) gaussdb_m=# SELECT localtime(3); localtime ------------------------- 2023-08-21 15:23:51.965 (1 row) 该函数在sql_compatibility = 'B'，且参数b_format_version值为5.7、b_format_dev_version值为s1时有效。

localtimestamp 描述：当前日期及时间。 返回值类型：timestamp 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 gaussdb=# SELECT localtimestamp; timestamp ---------------------------- 2017-09-01 17:03:30.781902 (1 row) -- B兼容模式下，打开兼容性参数 gaussdb_m=# SELECT localtimestamp; timestamp --------------------- 2023-08-21 15:27:55 (1 row) -- A兼容模式下,打开GUC参数a_format_date_timestamp时 gaussdb=# SET a_format_date_timestamp=on; SET gaussdb=# SELECT localtimestamp; localtimestamp ---------------------------- 2023-11-24 11:38:25.633231 (1 row) 该函数在sql_compatibility = 'B'，且参数b_format_version值为5.7、b_format_dev_version值为s1时有如下行为： 返回当前SQL语句执行开始时刻的系统日期和时间。 返回类型timestamp without time zone，列名为timestamp。 该函数在sql_compatibility = 'A'，且GUC参数a_format_date_timestamp值为on的情况下有如下行为： 返回值类型为timestamp without time zone，列名为localtimestamp。 返回的结果为当前SQL语句启动的系统时间的时间戳。 防止优化器提前获取常数时间，造成gplan场景下时间获取不正确。 关闭GUC参数a_format_date_timestamp，返回的结果为事务开启的系统的日期和时间。

now() 描述：当前事务的开始时刻的系统的日期及时间，同一个事务内返回结果相同。在sql_compatibility = 'B'，且参数b_format_version值为5.7、b_format_dev_version值为s1时返回当前SQL语句执行开始时刻的系统日期和时间。 返回值类型：timestamp with time zone，在sql_compatibility = 'B'，且参数b_format_version值为5.7、b_format_dev_version值为s1时返回类型为timestamp without time zone。 示例： 1 2 3 4 5 6 7 8 9 10 11 gaussdb=# SELECT now(); now ------------------------------- 2017-09-01 17:03:42.549426+08 (1 row) -- B模式下，打开兼容性参数 gaussdb_m=# SELECT now(); timestamp --------------------- 2023-08-21 17:17:42 (1 row)

localtimestamp([precision]) 描述：当前日期及时间。 参数：表示精度（秒后小数位数），int类型，取值范围为[0,6]，缺省时默认值为0，如果超过6，则发出告警，并输出精度为6时的时间值；其他无效值将导致报错。 返回值类型：timestamp without time zone 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 -- 带括号且无入参调用仅在B兼容模式下支持 gaussdb_m=# SELECT localtimestamp(); timestamp --------------------- 2023-08-21 15:27:59 (1 row) gaussdb_m=# SELECT localtimestamp(3); timestamp ------------------------- 2023-08-21 15:28:02.445 (1 row) -- A兼容模式下，打开GUC参数a_format_date_timestamp时 gaussdb=# SET a_format_date_timestamp=on; SET gaussdb=# SELECT localtimestamp(6); localtimestamp ---------------------------- 2023-11-24 11:41:14.086227 (1 row) -- A兼容模式数据库中且参数a_format_version值为10c、a_format_dev_version值为s2时，precision参数支持numeric类型的整值 gaussdb=# SET a_format_version='10c'; SET gaussdb=# SET a_format_dev_version='s2'; SET gaussdb=# SELECT localtimestamp(6.0); localtimestamp ---------------------------- 2023-11-24 11:42:45.642167 (1 row) 微秒末位的0不显示，如2017-09-01 10:32:19.212000输出显示为2017-09-01 10:32:19.212。 该函数在sql_compatibility = 'B'，且参数b_format_version值为5.7、b_format_dev_version值为s1时，返回当前SQL语句执行开始时刻的系统日期和时间，支持带括号且无入参调用。 该函数在sql_compatibility = 'A'，且GUC参数a_format_date_timestamp值为on的情况下有以下行为： 返回当前SQL语句启动时的系统时间的时间戳。 返回值类型为timestamp without time zone，列名为localtimestamp。 参数a_format_version值为10c、a_format_dev_version值为s2时，precision参数支持numeric类型的整值，否则仅支持int输入。 关闭GUC参数a_format_date_timestamp，返回的结果为事务开启的系统的日期和时间。

daterange(arg1, arg2) 描述：获取时间边界信息。 参数：arg1和arg2的类型为date。 返回值类型：daterange 示例： 1 2 3 4 5 gaussdb=# SELECT daterange('2000-05-06','2000-08-08'); daterange ------------------------- [2000-05-06,2000-08-08) (1 row)

daterange(arg1, arg2, text) 描述：获取时间边界信息。 参数：arg1和arg2的类型为date，text类型为text。 返回值类型：daterange 示例： 1 2 3 4 5 gaussdb=# SELECT daterange('2000-05-06','2000-08-08','[]'); daterange ------------------------- [2000-05-06,2000-08-09) (1 row)

isfinite(date) 描述：判断日期是否为有限值，是则返回t，否则返回f。 返回值类型：Boolean 示例： 1 2 3 4 5 6 7 8 9 10 gaussdb=# SELECT isfinite(date '2001-02-16'); isfinite ---------- t (1 row) gaussdb=# SELECT isfinite(date 'infinity'); isfinite ---------- f (1 row)

round(arg1, arg2) 描述：四舍五入到arg2指定的精度。 参数： arg1类型：timestamp without time zone arg2类型：text 返回值类型：timestamp without time zone 示例： 1 2 3 4 gaussdb=# SELECT round(timestamp '2001-02-16 20:38:40', 'hour'); round --------------------- 2001-02-16 21:00:00 (1 row) 此函数在A兼容模式数据库中且参数a_format_version值为10c和a_format_dev_version值为s1的情况下有效。

trunc(arg1, arg2) 描述：截取到arg2指定的精度。 参数： arg1类型：interval、timestamp with time zone以及timestamp without time zone。 arg2类型：text。arg2支持的单位列表如表1所示。 表1 arg2支持的单位列表 单位 含义 mil、mils、millennia、millennium 千禧年 c、cc、cent、centuries、century 世纪 dec、decade、decades、decs 年代 y、year、years、yr、yrs、yyyy 年 q、qtr、quarter 季度 mm、mon、mons、month、months 月 w、week、weeks 周 j、d、day、days、dd、ddd 天 h、hh、hour、hours、hr、hrs 小时 m、mi、min、mins、minute、minutes 分钟 s、sec、second、seconds、secs 秒 millisecon、ms、msec、msecond、mseconds、msecs 毫秒 microsecon、us、usec、usecond、useconds、usecs 微秒 返回值类型：interval、timestamp with time zone以及timestamp without time zone。 示例： 1 2 3 4 gaussdb=# SELECT trunc(timestamp '2001-02-16 20:38:40', 'hour'); trunc --------------------- 2001-02-16 20:00:00 (1 row)

isfinite(timestamp) 描述：判断时间戳是否为有限值，是则返回t，否则返回f。 返回值类型：Boolean 示例： 1 2 3 4 5 6 7 8 9 10 gaussdb=# SELECT isfinite(timestamp '2001-02-16 21:28:30'); isfinite ---------- t (1 row) gaussdb=# SELECT isfinite(timestamp 'infinity'); isfinite ---------- f (1 row)

justify_interval(interval) 描述：结合justify_days和justify_hours，调整interval。 返回值类型：interval 示例： 1 2 3 4 5 gaussdb=# SELECT JUSTIFY_INTERVAL(INTERVAL '1 MON -1 HOUR'); justify_interval ------------------ 29 days 23:00:00 (1 row)

date_part(text, interval) 描述：获取日期/时间值中子域的值。获取月份值时，如果月份值大于12，则取与12的模。等效于extract(field from timestamp)。 返回值类型：double precision 示例： 1 2 3 4 5 gaussdb=# SELECT date_part('month', interval '2 years 3 months'); date_part ----------- 3 (1 row)

date_part(text, timestamp) 描述：获取日期/时间值中子域的值，例如年或者小时的值。等效于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 示例： 1 2 3 4 5 gaussdb=# SELECT date_part('hour', timestamp '2001-02-16 20:38:40'); date_part ----------- 20 (1 row)

pg_systimestamp() 描述：当前日期和时间（当前语句的开始）。 返回值类型：timestamp with time zone 示例： 1 2 3 4 5 gaussdb=# SELECT pg_systimestamp(); pg_systimestamp ------------------------------- 2015-10-14 11:21:28.317367+08 (1 row)

systimestamp(precision) 描述：获取当前系统日期及时间，并将结果的微秒部分按照指定precision进行显示。 参数：precision表示精度（秒后小数位数）。INT类型，取值范围[0,6]，默认值为6，当超过6时提示WARNING，输出精度为6的时间值。 返回值类型：timestamp with time zone 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 gaussdb=# SELECT systimestamp(6); systimestamp ------------------------------- 2024-04-16 15:55:21.614342+08 (1 row) gaussdb=# SELECT systimestamp(9); WARNING: TIMESTAMP(9) WITH TIME ZONE precision reduced to maximum allowed, 6 CONTEXT: referenced column: systimestamp systimestamp ------------------------------- 2024-04-16 15:59:49.492505+08 (1 row) gaussdb=# SELECT systimestamp(5.0); systimestamp ------------------------------ 2024-04-16 16:00:23.48079+08 (1 row) 该函数仅在sql_compatibility = 'A'时生效。

trunc(timestamp) 描述：默认按天截取。 参数：类型为timestamp with time zone、timestamp without time zone。 返回值类型： timestamp without time zone 示例： 1 2 3 4 5 6 7 8 9 10 gaussdb=# SELECT trunc(TIMESTAMP '2001-02-16 20:38:40'); trunc --------------------- 2001-02-16 00:00:00 (1 row) gaussdb=# SELECT trunc(TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40'); trunc --------------------- 2001-02-16 00:00:00 (1 row)

systimestamp() 描述：获取当前系统的日期和时间。 返回值类型：timestamp with time zone 示例： 1 2 3 4 5 6 7 8 9 10 11 12 gaussdb=# SELECT systimestamp(); systimestamp ------------------------------- 2024-04-16 15:55:21.614342+08 (1 row) -- behavior_compat_options参数设置sys_function_without_brackets后，支持不带括号调用。 gaussdb=# SET behavior_compat_options='sys_function_without_brackets'; gaussdb=# SELECT systimestamp; systimestamp ------------------------------- 2024-04-16 15:55:21.614342+08 (1 row) 该函数仅在sql_compatibility = 'A'时生效。

date_trunc(text, timestamp) 描述：截取到参数text指定的精度。 返回值类型：interval、timestamp with time zone以及timestamp without time zone。 示例： 1 2 3 4 5 gaussdb=# SELECT date_trunc('hour', timestamp '2001-02-16 20:38:40'); date_trunc --------------------- 2001-02-16 20:00:00 (1 row)

current_time([precision]) 描述：返回当前SQL语句执行开始时刻的系统时间。 参数：表示精度（秒后小数位数），int类型，范围为[0,6]，缺省时默认值为0，无效精度值都报错。 返回值类型：time without time zone 实现方式：映射成系统函数curtime。 示例： gaussdb_m=# SELECT current_time(); current_time -------------- 15:14:05 (1 row) gaussdb_m=# SELECT current_time(3); current_time -------------- 15:14:08.433 (1 row) 该函数在sql_compatibility = 'B'，且参数b_format_version值为5.7、b_format_dev_version值为s1时有效。current_time实际调用的函数为curtime，可以用“\df curtime”指令查询函数详细入参和返回值。

current_timestamp(precision) 描述：当前日期及时间，并将结果中的微秒部分按照指定小数位进行显示。 参数：precision表示精度（秒后小数位数），int类型，范围为[0,6]，缺省时默认值为0，如果超过6，则发出告警，并输出精度为6时的时间值；其他无效值将导致报错。 返回值类型：B模式库中的5.7版本下（sql_compatibility = 'B'、b_format_version='5.7'、b_format_dev_version='s1'）返回类型为timestamp without time zone，其他场景下返回类型为timestamp with time zone。 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 gaussdb=# SELECT current_timestamp(1); timestamptz ------------------------------ 2017-09-01 16:58:19.2+08 (1 row) -- B模式库中的5.7版本下 gaussdb_m=# SELECT current_timestamp(1); timestamp ----------------------- 2023-08-21 15:09:35.3 (1 row) -- A兼容模式下，打开GUC参数a_format_date_timestamp时 gaussdb=# SET a_format_date_timestamp=on; SET gaussdb=# SELECT current_timestamp(6); current_timestamp ------------------------------- 2023-11-24 11:35:57.268592+08 (1 row) -- A兼容模式数据库中且参数a_format_version值为10c、a_format_dev_version值为s2时，precision参数支持numeric类型的整值 gaussdb=# SET a_format_version='10c'; SET gaussdb=# SET a_format_dev_version='s2'; SET gaussdb=# SELECT current_timestamp(6.0); current_timestamp ------------------------------- 2023-11-24 14:17:17.041117+08 (1 row) 微秒末位的0不显示。如2017-09-01 10:32:19.212000输出显示为 2017-09-01 10:32:19.212。 该函数在sql_compatibility = 'B'，且参数b_format_version值为5.7、b_format_dev_version值为s1时有如下行为： 返回类型为timestamp without time zone。 返回的结果为当前SQL语句启动时的系统时间的时间戳。 该函数通过TYPE转化实现，无实际注册函数，因此通过gsql工具的\df+等相关命令查看的为其他模式下的函数信息，而不是B兼容模式的5.7版本中的函数信息。 该函数在sql_compatibility = 'A'，且GUC参数a_format_date_timestamp值为on的情况下有如下行为： 返回值类型为timestamp with time zone，列名为current_timestamp。 返回的结果为当前SQL语句启动时的系统时间的时间戳。 当参数a_format_version值为10c、a_format_dev_version值为s2时，precision参数支持numeric类型的整值，否则仅支持int输入。 关闭GUC参数a_format_date_timestamp，当入参为不带小数点的整值时，返回的结果为事务开启的系统的日期和时间；当入参为带小数点的整值时，返回结果为当前SQL语句启动时的系统时间的时间戳。

current_timestamp 描述：当前日期及时间。 返回值类型：B模式库中的5.7版本下（sql_compatibility = 'B'、b_format_version='5.7'、b_format_dev_version='s1'）返回类型为timestamp without time zone，其他场景下返回类型为timestamp with time zone。 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 gaussdb=# SELECT current_timestamp; pg_systimestamp ------------------------------ 2017-09-01 16:58:19.22173+08 (1 row) -- B兼容模式数据库中的5.7版本下 gaussdb_m=# SELECT current_timestamp; timestamp --------------------- 2023-08-21 15:08:24 (1 row) -- A兼容模式下，打开GUC参数a_format_date_timestamp时 gaussdb=# SET a_format_date_timestamp=on; SET gaussdb=# SELECT current_timestamp; current_timestamp ------------------------------- 2023-11-24 11:31:04.895312+08 (1 row) 该函数在sql_compatibility = 'A'下，或者sql_compatibility = 'B'下未设置b_format_version、b_format_dev_version参数时，返回结果为最近一条SQL语句启动的系统时间的时间戳，返回值类型为timestamp with time zone，且GUC参数a_format_date_timestamp值为on的情况下，列名为current_timestamp。 在PL/SQL中，简单的赋值语句如：time1 := current_timestamp，被认为是表达式，所以会返回上一条SQL语句启动的系统时间的时间戳。 该函数在sql_compatibility = 'B'，且参数b_format_version值为5.7、b_format_dev_version值为s1时有如下行为： 返回类型为timestamp without time zone。 返回结果的精度为0。 返回的结果为当前SQL语句启动时的系统时间的时间戳。 该函数通过TYPE转化实现，无实际注册函数，因此通过gsql工具的\df+等相关命令查看的为其他兼容模式下的函数信息，而不是B兼容模式的5.7版本中的函数信息。 当在一个匿名块内多次调用该函数，整个匿名块将被视为一条语句，因此每次调用该函数都会返回相同的结果。

current_timestamp() 描述：当前日期及时间。 返回值类型：timestamp without time zone 示例： 1 2 3 4 5 gaussdb=# SELECT current_timestamp(); timestamp --------------------- 2023-08-21 14:34:30 (1 row) 该函数仅支持在sql_compatibility = 'B'，且参数b_format_version值为5.7、b_format_dev_version值为s1时使用，且有如下行为： 返回类型为timestamp without time zone。 返回结果的精度为0。 返回的结果为当前SQL语句启动时的系统时间的时间戳。 该函数通过TYPE转化实现，无实际注册函数，因此通过gsql工具的\df+等相关命令查看的为其他模式下的函数信息，而不是B兼容模式的5.7版本中的函数信息。

current_time 描述：当前事务开始时刻的系统时间。在sql_compatibility = 'B'，且参数b_format_version值为5.7、b_format_dev_version值为s1时，返回当前SQL语句执行开始时刻的系统时间。 返回值类型：time with time zone，在sql_compatibility = 'B'，且参数b_format_version值为5.7、b_format_dev_version值为s1时，类型是time without time zone。 示例： 1 2 3 4 5 6 7 8 9 10 11 12 gaussdb=# SELECT current_time; timetz -------------------- 16:58:07.086215+08 (1 row) -- B模式下打开参数时 gaussdb_m=# SELECT current_time; current_time -------------- 15:14:00 (1 row)

current_date 描述：返回当前SQL语句启动时的系统日期。 返回值类型：date 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 gaussdb=# SELECT current_date; date ------------ 2017-09-01 (1 row) -- A兼容模式下，打开GUC参数a_format_date_timestamp时 gaussdb=# SET a_format_date_timestamp=on; SET gaussdb=# SELECT current_date; current_date --------------------- 2023-11-24 11:25:09 (1 row) 该函数在sql_compatibility = 'A'，且GUC参数a_format_date_timestamp值为on的情况下有如下行为： 返回当前SQL语句启动时的系统时间的时间戳。 返回值类型为timestamp without time zone，保留到秒，列名为current_date。 参数a_format_version值为10c和a_format_dev_version值为s2的情况下返回值类型为timestamp。 关闭GUC参数a_format_date_timestamp，返回的结果为事务开启的系统时间的日期。 该函数在sql_compatibility = 'B'，且参数b_format_version值为5.7、b_format_dev_version值为s1时有如下行为： current_date支持带括号调用。 current_date实际调用的函数为curdate，可以用“\df curdate”指令查询函数详细入参和返回值。