● 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 timestamp)。
返回值类型: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 timestamp)。
返回值类型: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 AS RESULT;
result 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;
SETSELECT numtodsinterval(100, 'HOUR');
numtodsinterval +000000004 04:00:00.000000000 (1 row)
● pg_sleep(seconds)
描述:是服务器线程延迟时间,以秒记。
返回值类型:void 示例:
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) FROM dual;
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');