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

#### 时间日期操作符

 `1` ```SELECT date '2001-10-01' - '7' AS RESULT; ```

+

 ```1 2 3 4 5``` ```SELECT date '2001-09-28' + integer '7' AS RESULT; result --------------------- 2001-10-05 00:00:00 (1 row) ```
 ```1 2 3 4 5``` ```SELECT date '2001-09-28' + interval '1 hour' AS RESULT; result --------------------- 2001-09-28 01:00:00 (1 row) ```
 ```1 2 3 4 5``` ```SELECT date '2001-09-28' + time '03:00' AS RESULT; result --------------------- 2001-09-28 03:00:00 (1 row) ```
 ```1 2 3 4 5``` ```SELECT interval '1 day' + interval '1 hour' AS RESULT; result ---------------- 1 day 01:00:00 (1 row) ```
 ```1 2 3 4 5``` ```SELECT timestamp '2001-09-28 01:00' + interval '23 hours' AS RESULT; result --------------------- 2001-09-29 00:00:00 (1 row) ```
 ```1 2 3 4 5``` ```SELECT time '01:00' + interval '3 hours' AS RESULT; result ---------- 04:00:00 (1 row) ```

-

 ```1 2 3 4 5``` ```SELECT date '2001-10-01' - date '2001-09-28' AS RESULT; result -------- 3 days (1 row) ```
 ```1 2 3 4 5``` ```SELECT date '2001-10-01' - integer '7' AS RESULT; result --------------------- 2001-09-24 00:00:00 (1 row) ```
 ```1 2 3 4 5``` ```SELECT date '2001-09-28' - interval '1 hour' AS RESULT; result --------------------- 2001-09-27 23:00:00 (1 row) ```
 ```1 2 3 4 5``` ```SELECT time '05:00' - time '03:00' AS RESULT; result ---------- 02:00:00 (1 row) ```
 ```1 2 3 4 5``` ```SELECT time '05:00' - interval '2 hours' AS RESULT; result ---------- 03:00:00 (1 row) ```
 ```1 2 3 4 5``` ```SELECT timestamp '2001-09-28 23:00' - interval '23 hours' AS RESULT; result --------------------- 2001-09-28 00:00:00 (1 row) ```
 ```1 2 3 4 5``` ```SELECT interval '1 day' - interval '1 hour' AS RESULT; result ---------- 23:00:00 (1 row) ```
 ```1 2 3 4 5``` ```SELECT timestamp '2001-09-29 03:00' - timestamp '2001-09-27 12:00' AS RESULT; result ---------------- 1 day 15:00:00 (1 row) ```

*

 ```1 2 3 4 5``` ```SELECT 900 * interval '1 second' AS RESULT; result ---------- 00:15:00 (1 row) ```
 ```1 2 3 4 5``` ```SELECT 21 * interval '1 day' AS RESULT; result --------- 21 days (1 row) ```
 ```1 2 3 4 5``` ```SELECT double precision '3.5' * interval '1 hour' AS RESULT; result ---------- 03:30:00 (1 row) ```

/

 ```1 2 3 4 5``` ```SELECT interval '1 hour' / double precision '1.5' AS RESULT; result ---------- 00:40:00 (1 row) ```

#### 时间/日期函数

• age(timestamp, timestamp)

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

返回值类型：interval

示例：

 ```1 2 3 4 5``` ```SELECT age(timestamp '2001-04-10', timestamp '1957-06-13'); age ------------------------- 43 years 9 mons 27 days (1 row) ```
• age(timestamp)

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

返回值类型：interval

示例：

 ```1 2 3 4 5``` ```SELECT age(timestamp '1957-06-13'); age ------------------------- 60 years 2 mons 18 days (1 row) ```
• clock_timestamp()

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

返回值类型：timestamp with time zone

示例：

 ```1 2 3 4 5``` ```SELECT clock_timestamp(); clock_timestamp ------------------------------- 2017-09-01 16:57:36.636205+08 (1 row) ```
• current_date

描述：当前日期。

返回值类型：date

示例：

 ```1 2 3 4 5``` ```SELECT current_date; date ------------ 2017-09-01 (1 row) ```
• current_time

描述：当前时间。

返回值类型：time with time zone

示例：

 ```1 2 3 4 5``` ```SELECT current_time; timetz -------------------- 16:58:07.086215+08 (1 row) ```
• current_timestamp

描述：当前日期及时间。

返回值类型：timestamp with time zone

示例：

 ```1 2 3 4 5``` ```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

示例：

 ```1 2 3 4 5``` ```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

示例：

 ```1 2 3 4 5``` ```SELECT date_part('month', interval '2 years 3 months'); date_part ----------- 3 (1 row) ```
• date_trunc(text, timestamp)

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

返回值类型：timestamp

示例：

 ```1 2 3 4 5``` ```SELECT date_trunc('hour', timestamp '2001-02-16 20:38:40'); date_trunc --------------------- 2001-02-16 20:00:00 (1 row) ```
• trunc(timestamp)

描述：默认按天截取。

示例：

 ```1 2 3 4``` ```SELECT trunc(timestamp '2001-02-16 20:38:40'); trunc --------------------- 2001-02-16 00:00:00 (1 row) ```
• extract(field from timestamp)

描述：获取小时的值。

返回值类型：double precision

示例：

 ```1 2 3 4 5``` ```SELECT extract(hour from timestamp '2001-02-16 20:38:40'); date_part ----------- 20 (1 row) ```
• extract(field from interval)

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

返回值类型：double precision

示例：

 ```1 2 3 4 5``` ```SELECT extract(month from interval '2 years 3 months'); date_part ----------- 3 (1 row) ```
• isfinite(date)

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

返回值类型：boolean

示例：

 ```1 2 3 4 5``` ```SELECT isfinite(date '2001-02-16'); isfinite ---------- t (1 row) ```
• isfinite(timestamp)

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

返回值类型：boolean

示例：

 ```1 2 3 4 5``` ```SELECT isfinite(timestamp '2001-02-16 21:28:30'); isfinite ---------- t (1 row) ```
• isfinite(interval)

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

返回值类型：boolean

示例：

 ```1 2 3 4 5``` ```SELECT isfinite(interval '4 hours'); isfinite ---------- t (1 row) ```
• justify_days(interval)

描述：将时间间隔以30天为单位，表示为月。

返回值类型：interval

示例：

 ```1 2 3 4 5``` ```SELECT justify_days(interval '35 days'); justify_days -------------- 1 mon 5 days (1 row) ```
• justify_hours(interval)

描述：将时间间隔以24小时为单位，表示为天。

返回值类型：interval

示例：

 ```1 2 3 4 5``` ```SELECT JUSTIFY_HOURS(INTERVAL '27 HOURS'); justify_hours ---------------- 1 day 03:00:00 (1 row) ```
• justify_interval(interval)

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

返回值类型：interval

示例：

 ```1 2 3 4 5``` ```SELECT JUSTIFY_INTERVAL(INTERVAL '1 MON -1 HOUR'); justify_interval ------------------ 29 days 23:00:00 (1 row) ```
• localtime

描述：当前时间。

返回值类型：time

示例：

 ```1 2 3 4 5``` ```SELECT localtime AS RESULT; result ---------------- 16:05:55.664681 (1 row) ```
• localtimestamp

描述：当前日期及时间。

返回值类型：timestamp

示例：

 ```1 2 3 4 5``` ```SELECT localtimestamp; timestamp ---------------------------- 2017-09-01 17:03:30.781902 (1 row) ```
• now()

描述：当前日期及时间。

返回值类型：timestamp with time zone

示例：

 ```1 2 3 4 5``` ```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输出格式。

示例：

 ``` 1 2 3 4 5 6 7 8 9 10 11 12 13``` ```SELECT numtodsinterval(100, 'HOUR'); numtodsinterval ----------------- 100:00:00 (1 row) SET intervalstyle = oracle; SET SELECT numtodsinterval(100, 'HOUR'); numtodsinterval ------------------------------- +000000004 04:00:00.000000000 (1 row) ```
• pg_sleep(seconds)

描述：是服务器线程延迟时间，以秒记。

返回值类型：void

示例：

 ```1 2 3 4 5``` ```SELECT pg_sleep(10); pg_sleep ---------- (1 row) ```
• statement_timestamp()

描述：当前日期及时间。

返回值类型：timestamp with time zone

示例：

 ```1 2 3 4 5``` ```SELECT statement_timestamp(); statement_timestamp ------------------------------- 2017-09-01 17:04:39.119267+08 (1 row) ```
• sysdate

描述：当前日期及时间。

返回值类型：timestamp

示例：

 ```1 2 3 4 5``` ```SELECT sysdate; sysdate --------------------- 2017-09-01 17:04:49 (1 row) ```
• timeofday()

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

返回值类型：text

示例：

 ```1 2 3 4 5``` ```SELECT timeofday(); timeofday ------------------------------------- Fri Sep 01 17:05:01.167506 2017 CST (1 row) ```
• transaction_timestamp()

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

返回值类型：timestamp with time zone

示例：

 ```1 2 3 4 5``` ```SELECT transaction_timestamp(); transaction_timestamp ------------------------------- 2017-09-01 17:05:13.534454+08 (1 row) ```

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

返回值类型：timestamp

示例：

 ```1 2 3 4 5``` ```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

示例：

 ```1 2 3 4 5``` ```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

示例：

 ```1 2 3 4 5``` ```postgres=# select next_day(timestamp '2017-05-25 00:00:00','Sunday')AS cal_result; cal_result --------------------- 2017-05-28 00:00:00 (1 row) ```

#### EXTRACT

EXTRACT(field FROM source)

extract函数从日期或时间的数值里抽取子域，比如年、小时等。source必须是一个timestamp、time或interval类型的值表达式（类型为date的表达式转换为timestamp，因此也可以用）。field是一个标识符或者字符串，它指定从源数据中抽取的域。extract函数返回类型为double precision的数值。field的取值范围如下所示。

• century

世纪。

示例：

 ```1 2 3 4 5``` ```SELECT EXTRACT(CENTURY FROM TIMESTAMP '2000-12-16 12:21:13'); date_part ----------- 20 (1 row) ```
• day
• 如果source为timestamp，表示月份里的日期（1-31）。
 ```1 2 3 4 5``` ```SELECT EXTRACT(DAY FROM TIMESTAMP '2001-02-16 20:38:40'); date_part ----------- 16 (1 row) ```
• 如果source为interval，表示天数。
 ```1 2 3 4 5``` ```SELECT EXTRACT(DAY FROM INTERVAL '40 days 1 minute'); date_part ----------- 40 (1 row) ```

年份除以10。

 ```1 2 3 4 5``` ```SELECT EXTRACT(DECADE FROM TIMESTAMP '2001-02-16 20:38:40'); date_part ----------- 200 (1 row) ```
• dow

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

 ```1 2 3 4 5``` ```SELECT EXTRACT(DOW FROM TIMESTAMP '2001-02-16 20:38:40'); date_part ----------- 5 (1 row) ```
• doy

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

 ```1 2 3 4 5``` ```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，表示时间间隔的总秒数。

 ```1 2 3 4 5``` ```SELECT EXTRACT(EPOCH FROM TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40.12-08'); date_part -------------- 982384720.12 (1 row) ```
 ```1 2 3 4 5``` ```SELECT EXTRACT(EPOCH FROM INTERVAL '5 days 3 hours'); date_part ----------- 442800 (1 row) ```
• 将epoch值转换为时间戳的方法。
 ```1 2 3 4 5``` ```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）。

 ```1 2 3 4 5``` ```SELECT EXTRACT(HOUR FROM TIMESTAMP '2001-02-16 20:38:40'); date_part ----------- 20 (1 row) ```
• isodow

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

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

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

 ```1 2 3 4 5``` ```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描述。

 ```1 2 3 4 5``` ```SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-01'); date_part ----------- 2005 (1 row) ```
 ```1 2 3 4 5``` ```SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-02'); date_part ----------- 2006 (1 row) ```
• microseconds

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

 ```1 2 3 4 5``` ```SELECT EXTRACT(MICROSECONDS FROM TIME '17:12:28.5'); date_part ----------- 28500000 (1 row) ```
• millennium

千年。

20世纪（19xx年）里面的年份在第二个千年里。第三个千年从2001年1月1日零时开始。

 ```1 2 3 4 5``` ```SELECT EXTRACT(MILLENNIUM FROM TIMESTAMP '2001-02-16 20:38:40'); date_part ----------- 3 (1 row) ```
• milliseconds

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

 ```1 2 3 4 5``` ```SELECT EXTRACT(MILLISECONDS FROM TIME '17:12:28.5'); date_part ----------- 28500 (1 row) ```
• minute

分钟域（0-59）。

 ```1 2 3 4 5``` ```SELECT EXTRACT(MINUTE FROM TIMESTAMP '2001-02-16 20:38:40'); date_part ----------- 38 (1 row) ```
• month

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

 ```1 2 3 4 5``` ```SELECT EXTRACT(MONTH FROM TIMESTAMP '2001-02-16 20:38:40'); date_part ----------- 2 (1 row) ```

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

 ```1 2 3 4 5``` ```SELECT EXTRACT(MONTH FROM INTERVAL '2 years 13 months'); date_part ----------- 1 (1 row) ```
• quarter

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

 ```1 2 3 4 5``` ```SELECT EXTRACT(QUARTER FROM TIMESTAMP '2001-02-16 20:38:40'); date_part ----------- 1 (1 row) ```
• second

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

 ```1 2 3 4 5``` ```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一起使用以得到一致的结果。

 ```1 2 3 4 5``` ```SELECT EXTRACT(WEEK FROM TIMESTAMP '2001-02-16 20:38:40'); date_part ----------- 7 (1 row) ```
• year

年份域。

 ```1 2 3 4 5``` ```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)

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

HH

HH12

HH24

MI

SS

FF

SSSSS

AM或A.M.

PM或P.M.

Y,YYY

SYYYY

YYYY

YYY

YY

Y

IYYY

ISO年（4位或更多位）

IYY

ISO年的最后三位

IY

ISO年的最后两位

I

ISO年的最后一位

RR

RRRR

• BC或B.C.

MONTH

MON

MM

RM

DAY

DY

DDD

DD

D

W

WW

IW

ISO一年里的周数（第一个星期四在第一周里）

CC

J

Q

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

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

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

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

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

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

*必选