暂无图片
暂无图片
暂无图片
暂无图片
暂无图片

GBase 8c V3.0.0数据类型——时间/日期函数

夏日晴空 2022-06-22
794

l age(timestamp, timestamp)

描述:将两个参数相减,并以年、月、日作为返回值。若相减值为负,则函数返回亦为负。两个参数类型必须相同,可以都带timezone,或都不带timezone。

返回值类型:interval

示例:

gbase=# SELECT age(timestamp '2001-04-10', timestamp '1957-06-13');

           age           

-------------------------

 43 years 9 mons 27 days

(1 row)

age(timestamp)

描述:当前时间和参数相减,入参可以带或者不带timezone。

返回值类型:interval

示例:

gbase=# SELECT age(timestamp '1957-06-13');

           age

-------------------------

 64 years 11 mons 4 days

(1 row)

clock_timestamp()

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

返回值类型:timestamp with time zone

示例:

gbase=# SELECT clock_timestamp();

        clock_timestamp

-------------------------------

 2022-05-17 16:34:14.629575+08

(1 row)

current_date

描述:当前时间。

返回值类型:date

示例:

gbase=# SELECT current_date;

    date

------------

 2022-05-17

(1 row)

current_time

描述:当前时间。

返回值类型:time with time zone

示例:

gbase=# SELECT current_time;

       timetz

--------------------

 16:35:00.099149+08

(1 row)

current_timestamp

描述:当前日期及时间。

返回值类型:timestamp with time zone

示例:

gbase=# SELECT current_timestamp;

        pg_systimestamp

-------------------------------

 2022-05-17 16:35:08.018834+08

(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。

返回值类型:date

示例:

gbase=# 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

示例:

gbase=# SELECT date_part('month', interval '2 years 3 months'); 

date_part

-----------

3

(1 row)

date_trunc(text, timestamp)

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

返回值类型:interval、timestamp with time zone、timestamp without time zone

示例:

gbase=# SELECT date_trunc('hour', timestamp '2001-02-16 20:38:40');

 date_trunc

---------------------

 2001-02-16 20:00:00

(1 row)

trunc(timestamp)

描述:默认按天截取。示例:

gbase=# SELECT trunc(timestamp '2001-02-16 20:38:40');

trunc

---------------------

2001-02-16 00:00:00

(1 row)

trunc(arg1, arg2)

描述:截取到arg2指定的精度。

arg1类型:interval、timestamp with time zone、timestamp without time zone

arg2类型:text

返回值类型:interval、timestamp with time zone、timestamp without time zone

示例:

gbase=# SELECT trunc(timestamp '2001-02-16 20:38:40', 'hour');

trunc

---------------------

 2001-02-16 20:00:00

(1 row)

daterange(arg1, arg2)

描述:获取时间边界信息。arg1和arg2的类型为date。

返回值类型:daterange 示例:

gbase=# 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

示例:

gbase=# select daterange('2000-05-06','2000-08-08','[]');

 daterange

-------------------------

[2000-05-06,2000-08-09)

(1 row)

extract(field from timestamp)

描述:获取小时的值。

返回值类型:double precision

示例:

gbase=# SELECT extract(hour from timestamp '2001-02-16 20:38:40');

 date_part

-----------

20

(1 row)

extract(field from interval)

描述:获取月份的值。如果大于12,则取与12的模。返回值类型:double precision

示例:

gbase=# SELECT extract(month from interval '2 years 3 months');

 date_part

-----------

3

(1 row)

isfinite(date)

描述:测试是否为有效日期。返回值类型:Boolean

示例:

gbase=# SELECT isfinite(date '2001-02-16');

 isfinite

----------

t

(1 row)

isfinite(timestamp)

描述:测试判断是否为有效时间。返回值类型:Boolean

示例:

gbase=# SELECT isfinite(timestamp '2001-02-16 21:28:30');

isfinite

----------

t

(1 row)

isfinite(interval)

描述:测试是否为有效区间。返回值类型:Boolean

示例:

gbase=# SELECT isfinite(interval '4 hours');

isfinite

----------

t

(1 row)

justify_days(interval)

描述:将时间间隔以月(30天为一月)为单位。返回值类型:interval

示例:

gbase=# SELECT justify_days(interval '35 days');

 justify_days

--------------

1 mon 5 days

(1 row)

justify_hours(interval)

描述:将时间间隔以天(24小时为一天)为单位。返回值类型:interval

示例:

gbase=# SELECT JUSTIFY_HOURS(INTERVAL '27 HOURS');

justify_hours

----------------

1 day 03:00:00

(1 row)

justify_interval(interval)

描述:结合justify_days和justify_hours,调整interval。 返回值类型:interval

示例:

gbase=# SELECT JUSTIFY_INTERVAL(INTERVAL '1 MON -1 HOUR');

justify_interval

------------------

29 days 23:00:00

(1 row)

localtime

描述:当前时间。

返回值类型:time

示例:

gbase=# SELECT localtime AS RESULT;

     result

-----------------

 16:39:21.245672

(1 row)

localtimestamp

描述:当前日期及时间。返回值类型:timestamp 示例:

gbase=# SELECT localtimestamp;

         timestamp

----------------------------

 2022-05-17 16:39:41.292909

(1 row)

now()

描述:当前日期及时间。

返回值类型:timestamp with time zone

示例:

gbase=# SELECT now();

              now

-------------------------------

 2022-05-17 16:47:22.123899+08

(1 row)

timenow

描述:当前日期及时间。

返回值类型:timestamp with time zone

示例:

gbase=# select timenow();

        timenow

------------------------

 2022-05-17 16:55:05+08

(1 row)

numtodsinterval(num, interval_unit)

描述:将数字转换为interval类型。num为numeric类型数字,interval_unit为固定格式字符串('DAY' | 'HOUR' | 'MINUTE' | 'SECOND')。

可以通过设置参数IntervalStyle为a,兼容该函数interval输出格式。 示例:

gbase=# SELECT numtodsinterval(100, 'HOUR');

numtodsinterval

-----------------

100:00:00

(1 row)

gbase=# SET intervalstyle = a;

SET

gbase=# SELECT numtodsinterval(100, 'HOUR');

numtodsinterval

-------------------------------

+000000004 04:00:00.000000000

(1 row)

pg_sleep(seconds)

描述:服务器线程延迟时间,单位为秒。返回值类型:void

示例:

gbase=# SELECT pg_sleep(10);

pg_sleep

----------

(1 row)

statement_timestamp()

描述:当前日期及时间。

返回值类型:timestamp with time zone

示例:

gbase=# SELECT statement_timestamp();

     statement_timestamp

-------------------------------

 2022-05-17 16:56:15.024107+08

(1 row)

sysdate

描述:当前日期及时间。

返回值类型:timestamp

示例:

gbase=# SELECT sysdate;

       sysdate

---------------------

 2022-05-17 16:56:35

(1 row)

timeofday()

描述:当前日期及时间(像clock_timestamp,但是返回时为text)。返回值类型:text

示例:

gbase=# SELECT timeofday();

              timeofday

-------------------------------------

 Tue May 17 16:56:58.381310 2022 CST

(1 row)

transaction_timestamp()

描述:当前日期及时间,与current_timestamp等效。返回值类型:timestamp with time zone

示例:

gbase=# SELECT transaction_timestamp();

     transaction_timestamp

-------------------------------

 2022-05-17 16:57:15.156131+08

(1 row)

add_months(d,n)

描述:用于计算时间点d再加上n个月的时间。返回值类型:timestamp

示例:

gbase=# 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)

last_day(d)

描述:用于计算时间点d当月最后一天的时间。返回值类型:timestamp

示例:

gbase=# 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

示例:

gbase=# select next_day(timestamp '2017-05-25 00:00:00','Sunday')AS cal_result;

cal_result

---------------------

2017-05-28 00:00:00

(1 row)

tinterval(abstime, abstime)

描述:用两个绝对时间创建时间间隔。返回值类型:tinterval

示例:

gbase=# call tinterval(abstime 'May 10, 1947 23:59:12', abstime 'Mon May 1 00:30:30 1995');

                      tinterval

-----------------------------------------------------

 ["1947-05-10 23:59:12+09" "1995-05-01 00:30:30+08"]

(1 row)

tintervalend(tinterval)

描述:返回tinteval的结束时间。返回值类型:abstime

示例:

gbase=# select tintervalend('["Sep 4, 1983 23:59:12" "Oct4, 1983 23:59:12"]');

      tintervalend

------------------------

 1983-10-04 23:59:12+08

(1 row)

tintervalrel(tinterval)

描述:计算并返回tinterval的相对时间。返回值类型:reltime

示例:

gbase=# select tintervalrel('["Sep 4, 1983 23:59:12" "Oct4, 1983 23:59:12"]');

tintervalrel

--------------

 0-1

(1 row)

smalldatetime_ge

描述:判断是否第一个参数大于等于第二个参数。

参数:smalldatetime, smalldatetime

返回值类型:boolean

smalldatetime_cmp

描述:对比smalldatetime是否相等。

参数:smalldatetime,   smalldatetime

返回值类型:integer

smalldatetime_eq

描述:对比smalldatetime是否相等。

参数:smalldatetime,   smalldatetime

返回值类型:boolean。

smalldatetime_gt

描述:判断是否第一个参数大于第二个参数。

参数:smalldatetime, smalldatetime

返回值类型:boolean

smalldatetime_hash

描述:计算timestamp对应的哈希值。

参数:smalldatetime

返回值类型:integer

smalldatetime_in

描述:输入timestamp。

参数:cstring, oid, integer

返回值类型:smalldatetime

smalldatetime_larger

描述:返回较大的timestamp。

参数:smalldatetime, smalldatetime

返回值类型:smalldatetime

smalldatetime_le

描述:判断是否第一个参数小于等于第二个参数。

参数:smalldatetime, smalldatetime

返回值类型:boolean

smalldatetime_lt

描述:判断是否第一个参数小于第二个参数。

参数:smalldatetime, smalldatetime

返回值类型:boolean

smalldatetime_ne

描述:比较两个timestamp是否不相等。

参数:smalldatetime, smalldatetime

返回值类型:boolean

smalldatetime_out

描述:timestamp转换为外部形式。

参数:smalldatetime

返回值类型:cstring

smalldatetime_send

描述:timestamp转换为二进制格式。

参数:smalldatetime

返回值类型:bytea

smalldatetime_smaller

描述:返回较小的一个smalldatetime。

参数:smalldatetime, smalldatetime

返回值类型:smalldatetime

smalldatetime_to_abstime

描述:smalldatetime转换为abstime。

参数:smalldatetime

返回值类型:abstime

smalldatetime_to_time

描述:smalldatetime转换为time。

参数:smalldatetime

返回值类型:time without time zone

smalldatetime_to_timestamp

描述:smalldatetime转换为timestamp。

参数:smalldatetime

返回值类型:timestamp without time zone

smalldatetime_to_timestamptz

描述:smalldatetime转换为timestamptz。

参数:smalldatetime

返回值类型:timestamp with time zone

smalldatetime_to_varchar2

描述:smalldatetime转换为varchar2。

参数:smalldatetime

返回值类型:character varying

「喜欢这篇文章,您的关注和赞赏是给作者最好的鼓励」
关注作者
【版权声明】本文为墨天轮用户原创内容,转载时必须标注文章的来源(墨天轮),文章链接,文章作者等基本信息,否则作者和墨天轮有权追究责任。如果您发现墨天轮中有涉嫌抄袭或者侵权的内容,欢迎发送邮件至:contact@modb.pro进行举报,并提供相关证据,一经查实,墨天轮将立刻删除相关内容。

评论