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

时间日期操作符

时间和日期处理函数和操作符 - 图1 警告：

用户在使用时间和日期操作符时，对应的操作数请使用明确的类型前缀修饰，以确保数据库在解析操作数的时候能够与用户预期一致，不会产生用户非预期的结果。 比如下面示例没有明确数据类型就会出现异常错误。

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

表 1 时间和日期操作符

操作符 示例
+ 1. openGauss=# SELECT date ‘2001-9-28’ + integer ‘7’ AS RESULT; 2. result 3. ——————————- 4. 2001-10-05 00:00:00 5. (1 row)
1. openGauss=# SELECT date ‘2001-09-28’ + interval ‘1 hour’ AS RESULT; 2. result ——————————- 3. 2001-09-28 01:00:00 4. (1 row)
1. openGauss=# SELECT date ‘2001-09-28’ + time ‘03:00’ AS RESULT; 2. result ——————————- 3. 2001-09-28 03:00:00 4. (1 row)
1. openGauss=# SELECT interval ‘1 day’ + interval ‘1 hour’ AS RESULT; 2. result ———————— 3. 1 day 01:00:00 4. (1 row)
1. openGauss=# SELECT timestamp ‘2001-09-28 01:00’ + interval ‘23 hours’ AS RESULT; 2. result ——————————- 3. 2001-09-29 00:00:00 4. (1 row)
1. openGauss=# SELECT time ‘01:00’ + interval ‘3 hours’ AS RESULT; 2. result ————— 3. 04:00:00 4. (1 row)
- 1. openGauss=# SELECT date ‘2001-10-01’ - date ‘2001-09-28’ AS RESULT; 2. result 3. ———— 4. 3days 5. (1 row)
1. openGauss=# SELECT date ‘2001-10-01’ - integer ‘7’ AS RESULT; 2. result ——————————- 3. 2001-09-24 00:00:00 4. (1 row)
1. openGauss=# SELECT date ‘2001-09-28’ - interval ‘1 hour’ AS RESULT; 2. result ——————————- 3. 2001-09-27 23:00:00 4. (1 row)
1. openGauss=# SELECT time ‘05:00’ - time ‘03:00’ AS RESULT; 2. result ————— 3. 02:00:00 4. (1 row)
1. openGauss=# SELECT time ‘05:00’ - interval ‘2 hours’ AS RESULT; 2. result ————— 3. 03:00:00 4. (1 row)
1. openGauss=# SELECT timestamp ‘2001-09-28 23:00’ - interval ‘23 hours’ AS RESULT; 2. result ——————————- 3. 2001-09-28 00:00:00 4. (1 row)
1. openGauss=# SELECT interval ‘1 day’ - interval ‘1 hour’ AS RESULT; 2. result ————— 3. 23:00:00 4. (1 row)
1. openGauss=# SELECT timestamp ‘2001-09-29 03:00’ - timestamp ‘2001-09-27 12:00’ AS RESULT; 2. result ———————— 3. 1 day 15:00:00 4. (1 row)
1. openGauss=# SELECT 900 interval ‘1 second’ AS RESULT; 2. result ————— 3. 00:15:00 4. (1 row)
1. openGauss=# SELECT 21 interval ‘1 day’ AS RESULT; 2. result ————- 3. 21 days 4. (1 row)
1. openGauss=# SELECT double precision ‘3.5’ interval ‘1 hour’ AS RESULT; 2. result ————— 3. 03:30:00 4. (1 row)
/ 1. openGauss=# SELECT interval ‘1 hour’ / double precision ‘1.5’ AS RESULT; 2. result ————— 3. 00:40:00 4. (1 row)

时间/日期函数

  • age(timestamp, timestamp)

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

返回值类型：interval

示例：

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

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

返回值类型：interval

示例：

1. openGauss=# SELECT age(timestamp '1957-06-13'); 2. age 3. ------------------------- 4. 60 years 2 mons 18 days 5. (1 row) - clock_timestamp()

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

返回值类型：timestamp with time zone

示例：

1. openGauss=# SELECT clock_timestamp(); 2. clock_timestamp 3. ------------------------------- 4. 2017-09-01 16:57:36.636205+08 5. (1 row) - current_date

描述：当前日期。

返回值类型：date

示例：

1. openGauss=# SELECT current_date; 2. date 3. ------------ 4. 2017-09-01 5. (1 row) - current_time

描述：当前时间。

返回值类型：time with time zone

示例：

1. openGauss=# SELECT current_time; 2. timetz 3. -------------------- 4. 16:58:07.086215+08 5. (1 row) - current_timestamp

描述：当前日期及时间。

返回值类型：timestamp with time zone

示例：

1. openGauss=# SELECT current_timestamp; 2. pg_systimestamp 3. ------------------------------ 4. 2017-09-01 16:58:19.22173+08 5. (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. openGauss=# SELECT date_part('hour', timestamp '2001-02-16 20:38:40'); 2. date_part 3. ----------- 4. 20 5. (1 row) - date_part(text, interval)

描述：获取日期/时间值中子域的值。获取月份值时，如果月份值大于12，则取与12的模。等效于extract(field from timestamp)。

返回值类型：double precision

示例：

1. openGauss=# SELECT date_part('month', interval '2 years 3 months'); 2. date_part 3. ----------- 4. 3 5. (1 row) - date_trunc(text, timestamp)

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

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

示例：

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

描述：默认按天截取。

示例：

1. openGauss=# SELECT trunc(timestamp '2001-02-16 20:38:40'); trunc 2. --------------------- 3. 2001-02-16 00:00:00 4. (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

示例：

1. openGauss=# SELECT trunc(timestamp '2001-02-16 20:38:40', 'hour'); trunc 2. --------------------- 3. 2001-02-16 20:00:00 4. (1 row) - daterange(arg1, arg2)

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

返回值类型：daterange

示例：

1. openGauss=# select daterange('2000-05-06','2000-08-08'); 2. daterange 3. ------------------------- 4. [2000-05-06,2000-08-08) 5. (1 row) - daterange(arg1, arg2, text)

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

返回值类型：daterange

示例：

1. openGauss=# select daterange('2000-05-06','2000-08-08','[]'); 2. daterange 3. ------------------------- 4. [2000-05-06,2000-08-09) 5. (1 row) - extract(field from timestamp)

描述：获取小时的值。

返回值类型：double precision

示例：

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

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

返回值类型：double precision

示例：

1. openGauss=# SELECT extract(month from interval '2 years 3 months'); 2. date_part 3. ----------- 4. 3 5. (1 row) - isfinite(date)

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

返回值类型：Boolean

示例：

1. openGauss=# SELECT isfinite(date '2001-02-16'); 2. isfinite 3. ---------- 4. t 5. (1 row) - isfinite(timestamp)

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

返回值类型：Boolean

示例：

1. openGauss=# SELECT isfinite(timestamp '2001-02-16 21:28:30'); 2. isfinite 3. ---------- 4. t 5. (1 row) - isfinite(interval)

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

返回值类型：Boolean

示例：

1. openGauss=# SELECT isfinite(interval '4 hours'); 2. isfinite 3. ---------- 4. t 5. (1 row) - justify_days(interval)

描述：将时间间隔以月（30天为一月）为单位。

返回值类型：interval

示例：

1. openGauss=# SELECT justify_days(interval '35 days'); 2. justify_days 3. -------------- 4. 1 mon 5 days 5. (1 row) - justify_hours(interval)

描述：将时间间隔以天（24小时为一天）为单位。

返回值类型：interval

示例：

1. openGauss=# SELECT JUSTIFY_HOURS(INTERVAL '27 HOURS'); 2. justify_hours 3. ---------------- 4. 1 day 03:00:00 5. (1 row) - justify_interval(interval)

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

返回值类型：interval

示例：

1. openGauss=# SELECT JUSTIFY_INTERVAL(INTERVAL '1 MON -1 HOUR'); 2. justify_interval 3. ------------------ 4. 29 days 23:00:00 5. (1 row) - localtime

描述：当前时间。

返回值类型：time

示例：

1. openGauss=# SELECT localtime AS RESULT; 2. result 3. ---------------- 4. 16:05:55.664681 5. (1 row) - localtimestamp

描述：当前日期及时间。

返回值类型：timestamp

示例：

1. openGauss=# SELECT localtimestamp; 2. timestamp 3. ---------------------------- 4. 2017-09-01 17:03:30.781902 5. (1 row) - now()

描述：当前日期及时间。

返回值类型：timestamp with time zone

示例：

1. openGauss=# SELECT now(); 2. now 3. ------------------------------- 4. 2017-09-01 17:03:42.549426+08 5. (1 row) - timenow

描述：当前日期及时间。

返回值类型：timestamp with time zone

示例：

1. openGauss=# select timenow(); 2. timenow 3. ------------------------ 4. 2020-06-23 20:36:56+08 5. (1 row) - numtodsinterval(num, interval_unit)

描述：将数字转换为interval类型。num为numeric类型数字，interval_unit为固定格式字符串（’DAY’ | ‘HOUR’ | ‘MINUTE’ | ‘SECOND’）。

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

示例：

``` 1. openGauss=# SELECT numtodsinterval(100, 'HOUR'); 2. numtodsinterval 3. ----------------- 4. 100:00:00 5. (1 row)

  1. openGauss=# SET intervalstyle = a;
  2. SET
  3. openGauss=# SELECT numtodsinterval(100, 'HOUR');
  4. numtodsinterval
  6. +000000004 04:00:00.000000000
  7. (1 row) ```
  8. pg_sleep(seconds)

描述：服务器线程延迟时间，单位为秒。

返回值类型：void

示例：

``` 1. openGauss=# SELECT pg_sleep(10); 2. pg_sleep 3. ----------

  1. (1 row) ```
  2. statement_timestamp()

描述：当前日期及时间。

返回值类型：timestamp with time zone

示例：

1. openGauss=# SELECT statement_timestamp(); 2. statement_timestamp 3. ------------------------------- 4. 2017-09-01 17:04:39.119267+08 5. (1 row) - sysdate

描述：当前日期及时间。

返回值类型：timestamp

示例：

1. openGauss=# SELECT sysdate; 2. sysdate 3. --------------------- 4. 2017-09-01 17:04:49 5. (1 row) - timeofday()

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

返回值类型：text

示例：

1. openGauss=# SELECT timeofday(); 2. timeofday 3. ------------------------------------- 4. Fri Sep 01 17:05:01.167506 2017 CST 5. (1 row) - transaction_timestamp()

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

返回值类型：timestamp with time zone

示例：

1. openGauss=# SELECT transaction_timestamp(); 2. transaction_timestamp 3. ------------------------------- 4. 2017-09-01 17:05:13.534454+08 5. (1 row) - add_months(d,n)

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

d：timestamp类型的值，以及可以隐式转换为timestamp类型的值。

n：INTEGER类型的值，以及可以隐式转换为INTEGER类型的值。

返回值类型：timestamp

示例：

1. openGauss=# SELECT add_months(to_date('2017-5-29', 'yyyy-mm-dd'), 11) FROM sys_dummy; 2. add_months 3. --------------------- 4. 2018-04-29 00:00:00 5. (1 row) - last_day(d)

描述：用于计算时间点d当月最后一天的时间。

返回值类型：timestamp

示例：

1. openGauss=# select last_day(to_date('2017-01-01', 'YYYY-MM-DD')) AS cal_result; 2. cal_result 3. --------------------- 4. 2017-01-31 00:00:00 5. (1 row) - next_day(x,y)

描述：用于计算时间点x开始的下一个星期几（y）的时间。

返回值类型：timestamp

示例：

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

描述：用两个绝对时间创建时间间隔。

返回值类型：tinterval

示例：

1. openGauss=# call tinterval(abstime 'May 10, 1947 23:59:12', abstime 'Mon May 1 00:30:30 1995'); 2. tinterval 3. ----------------------------------------------------- 4. ["1947-05-10 23:59:12+09" "1995-05-01 00:30:30+08"] 5. (1 row) - tintervalend(tinterval)

描述：返回tinteval的结束时间。

返回值类型：abstime

示例：

1. openGauss=# select tintervalend('["Sep 4, 1983 23:59:12" "Oct4, 1983 23:59:12"]'); 2. tintervalend 3. ------------------------ 4. 1983-10-04 23:59:12+08 5. (1 row) - tintervalrel(tinterval)

描述：计算并返回tinterval的相对时间。

返回值类型：reltime

示例：

1. openGauss=# select tintervalrel('["Sep 4, 1983 23:59:12" "Oct4, 1983 23:59:12"]'); 2. tintervalrel 3. -------------- 4. 1 mon 5. (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

时间和日期处理函数和操作符 - 图2 说明：

获取当前时间有多种方式，请根据实际业务从场景选择合适的接口：

  1. 以下接口按照当前事务的开始时刻返回值：

1. CURRENT_DATE CURRENT_TIME CURRENT_TIME(precision) CURRENT_TIMESTAMP(precision) LOCALTIME LOCALTIMESTAMP LOCALTIME(precision) LOCALTIMESTAMP(precision)

其中CURRENT_TIME和CURRENT_TIMESTAMP(precision)传递带有时区的值；LOCALTIME和LOCALTIMESTAMP传递的值不带时区。CURRENT_TIME、LOCALTIME和 LOCALTIMESTAMP可以有选择地接受一个精度参数， 该精度导致结果的秒域被园整为指定小数位。如果没有精度参数，结果将被给予所能得到的全部精度。 因为这些函数全部都按照当前事务的开始时刻返回结果，所以它们的值在事务运行的整个期间内都不改变。 我们认为这是一个特性：目的是为了允许一个事务在“当前”时间上有一致的概念， 这样在同一个事务里的多个修改可以保持同样的时间戳。 2. 以下接口返回当前语句开始时间：

1. transaction_timestamp() statement_timestamp() now()

其中transaction_timestamp()等价于CURRENT_TIMESTAMP(precision)，但是其命名清楚地反映了它的返回值。statement_timestamp()返回当前语句的开始时刻（更准确的说是收到 客户端最后一条命令的时间）。statement_timestamp()和transaction_timestamp()在一个事务的第一条命令期间返回值相同，但是在随后的命令中却不一定相同。 now()等效于transaction_timestamp()。

  1. 以下接口返回函数被调用时的真实当前时间：

1. clock_timestamp() timeofday()

clock_timestamp()返回真正的当前时间，因此它的值甚至在同一条 SQL 命令中都会变化。timeofday()和clock_timestamp()相似，timeofday()也返回真实的当前时间，但是它的结果是一个格式化的text串，而不是timestamp with time zone值。

表2显示了可以用于截断日期和时间值的模板。

表 2 用于日期/时间截断的模式

类别 模式 描述
微秒 MICROSECON 截断日期/时间，精确到微秒（000000 - 999999）
US
USEC
USECOND
毫秒 MILLISECON 截断日期/时间，精确到毫秒（000 - 999）
MS
MSEC
MSECOND
秒 S 截断日期/时间，精确到秒（00 - 59）
SEC
SECOND
分钟 M 截断日期/时间，精确到分钟（00 - 59）
MI
MIN
MINUTE
小时 H 截断日期/时间，精确到小时（00 - 23）
HH
HOUR
HR
天 D 截断日期/时间，精确到天（01-01 - 12-31）
DAY
DD
DDD
J
周 W 截断日期/时间，精确到周（本周的第一天）
WEEK
月 MM 截断日期/时间，精确到月（本月的第一天）
MON
MONTH
季度 Q 截断日期/时间，精确到季度（本季度的第一天）
QTR
QUARTER
年 Y 截断日期/时间，精确到年（本年的第一天）
YEAR
YR
YYYY
十年 DEC 截断日期/时间，精确到十年（本十年的第一天）
DECADE
世纪 C 截断日期/时间，精确到世纪（本世纪的第一天）
CC
CENT
CENTURY
千年 MIL 截断日期/时间，精确到千年（本千年的第一天）
MILLENNIA
MILLENNIUM

TIMESTAMPDIFF

  • TIMESTAMPDIFF(unit , timestamp_expr1, timestamp_expr2)

timestampdiff函数是计算两个日期时间之间(timestamp_expr2-timestamp_expr1)的差值，并以unit形式返回结果。timestamp_expr1，timestamp_expr2必须是一个timestamp、timestamptz、date类型的值表达式。unit表示的是两个日期差的单位。

时间和日期处理函数和操作符 - 图3 说明：

该函数仅在openGauss兼容MY类型时（即dbcompatibility = ‘B’）有效，其他类型不支持该函数。

  • year

年份。

1. openGauss=# SELECT TIMESTAMPDIFF(YEAR, '2018-01-01', '2020-01-01'); 2. timestamp_diff 3. ---------------- 4. 2 5. (1 row) - quarter

季度。

1. openGauss=# SELECT TIMESTAMPDIFF(QUARTER, '2018-01-01', '2020-01-01'); 2. timestamp_diff 3. ---------------- 4. 8 5. (1 row) - month

月份。

1. openGauss=# SELECT TIMESTAMPDIFF(MONTH, '2018-01-01', '2020-01-01'); 2. timestamp_diff 3. ---------------- 4. 24 5. (1 row) - week

星期。

1. openGauss=# SELECT TIMESTAMPDIFF(WEEK, '2018-01-01', '2020-01-01'); 2. timestamp_diff 3. ---------------- 4. 104 5. (1 row) - day

天。

1. openGauss=# SELECT TIMESTAMPDIFF(DAY, '2018-01-01', '2020-01-01'); 2. timestamp_diff 3. ---------------- 4. 730 5. (1 row) - hour

小时。

1. openGauss=# SELECT TIMESTAMPDIFF(HOUR, '2020-01-01 10:10:10', '2020-01-01 11:11:11'); 2. timestamp_diff 3. ---------------- 4. 1 5. (1 row) - minute

分钟。

1. openGauss=# SELECT TIMESTAMPDIFF(MINUTE, '2020-01-01 10:10:10', '2020-01-01 11:11:11'); 2. timestamp_diff 3. ---------------- 4. 61 5. (1 row) - second

秒。

1. openGauss=# SELECT TIMESTAMPDIFF(SECOND, '2020-01-01 10:10:10', '2020-01-01 11:11:11'); 2. timestamp_diff 3. ---------------- 4. 3661 5. (1 row) - microseconds

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

1. openGauss=# SELECT TIMESTAMPDIFF(MICROSECOND, '2020-01-01 10:10:10.000000', '2020-01-01 10:10:10.111111'); 2. timestamp_diff 3. ---------------- 4. 111111 5. (1 row) - timestamp_expr含有时区

1. openGauss=# SELECT TIMESTAMPDIFF(HOUR,'2020-05-01 10:10:10-01','2020-05-01 10:10:10-03'); 2. timestamp_diff 3. ---------------- 4. 2 5. (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世纪。

示例：

1. openGauss=# SELECT EXTRACT(CENTURY FROM TIMESTAMP '2000-12-16 12:21:13'); 2. date_part 3. ----------- 4. 20 5. (1 row) - day

  • 如果source为timestamp，表示月份里的日期（1-31）。

    1. openGauss=# SELECT EXTRACT(DAY FROM TIMESTAMP '2001-02-16 20:38:40'); 2. date_part 3. ----------- 4. 16 5. (1 row) - 如果source为interval，表示天数。

    1. openGauss=# SELECT EXTRACT(DAY FROM INTERVAL '40 days 1 minute'); 2. date_part 3. ----------- 4. 40 5. (1 row) - decade

年份除以10。

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

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

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

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

1. openGauss=# SELECT EXTRACT(DOY FROM TIMESTAMP '2001-02-16 20:38:40'); 2. date_part 3. ----------- 4. 47 5. (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. openGauss=# SELECT EXTRACT(EPOCH FROM TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40.12-08'); 2. date_part 3. -------------- 4. 982384720.12 5. (1 row)

    1. openGauss=# SELECT EXTRACT(EPOCH FROM INTERVAL '5 days 3 hours'); 2. date_part 3. ----------- 4. 442800 5. (1 row) - 将epoch值转换为时间戳的方法。

    1. openGauss=# SELECT TIMESTAMP WITH TIME ZONE 'epoch' + 982384720.12 * INTERVAL '1 second' AS RESULT; 2. result 3. --------------------------- 4. 2001-02-17 12:38:40.12+08 5. (1 row) - hour

小时域（0-23）。

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

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

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

时间和日期处理函数和操作符 - 图4 说明：

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

1. openGauss=# SELECT EXTRACT(ISODOW FROM TIMESTAMP '2001-02-18 20:38:40'); 2. date_part 3. ----------- 4. 7 5. (1 row) - isoyear

日期中的ISO 8601标准年（不适用于间隔）。

每个带有星期一开始的周中包含1月4日的ISO年，所以在年初的1月或12月下旬的ISO年可能会不同于阳历的年。详细信息请参见后续的week描述。

1. openGauss=# SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-01'); 2. date_part 3. ----------- 4. 2005 5. (1 row)

1. openGauss=# SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-02'); 2. date_part 3. ----------- 4. 2006 5. (1 row) - microseconds

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

1. openGauss=# SELECT EXTRACT(MICROSECONDS FROM TIME '17:12:28.5'); 2. date_part 3. ----------- 4. 28500000 5. (1 row) - millennium

千年。

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

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

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

1. openGauss=# SELECT EXTRACT(MILLISECONDS FROM TIME '17:12:28.5'); 2. date_part 3. ----------- 4. 28500 5. (1 row) - minute

分钟域（0-59）。

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

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

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

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

1. openGauss=# SELECT EXTRACT(MONTH FROM INTERVAL '2 years 13 months'); 2. date_part 3. ----------- 4. 1 5. (1 row) - quarter

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

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

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

1. openGauss=# SELECT EXTRACT(SECOND FROM TIME '17:12:28.5'); 2. date_part 3. ----------- 4. 28.5 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. openGauss=# SELECT EXTRACT(WEEK FROM TIMESTAMP '2001-02-16 20:38:40'); 2. date_part 3. ----------- 4. 7 5. (1 row) - year

年份域。

1. openGauss=# SELECT EXTRACT(YEAR FROM TIMESTAMP '2001-02-16 20:38:40'); 2. date_part 3. ----------- 4. 2001 5. (1 row)

date_part

date_part函数是在传统的Ingres函数的基础上制作的（该函数等效于SQL标准函数extract）：

  • date_part(‘field‘, source)

这里的field参数必须是一个字符串，而不是一个名称。有效的field与extract一样，详细信息请参见EXTRACT。

示例：

1. openGauss=# SELECT date_part('day', TIMESTAMP '2001-02-16 20:38:40');
2. date_part
3. -----------
4. 16
5. (1 row)

1. openGauss=# SELECT date_part('hour', INTERVAL '4 hours 3 minutes');
2. date_part
3. -----------
4. 4
5. (1 row)

表3显示了可以用于格式化日期和时间值的模版。

表 3 用于日期/时间格式化的模式

类别 模式 描述
小时 HH 一天的小时数（01-12）
HH12 一天的小时数（01-12）
HH24 一天的小时数（00-23）
分钟 MI 分钟（00-59）
秒 SS 秒（00-59）
FF 微秒（000000-999999）
SSSSS 午夜后的秒（0-86399）
上、下午 AM或A.M. 上午标识
PM或P.M. 下午标识
年 Y,YYY 带逗号的年（4和更多位）
SYYYY 公元前四位年
YYYY 年（4和更多位）
YYY 年的后三位
YY 年的后两位
Y 年的最后一位
IYYY ISO年（4位或更多位）
IYY ISO年的最后三位
IY ISO年的最后两位
I ISO年的最后一位
RR 年的后两位（可在21世纪存储20世纪的年份）
RRRR 可接收4位年或两位年。若是两位，则和RR的返回值相同，若是四位，则和YYYY相同。
- BC或B.C. - AD或A.D. 纪元标识。BC（公元前），AD（公元后）。
月 MONTH 全长大写月份名（空白填充为9字符）
MON 大写缩写月份名（3字符）
MM 月份数（01-12）
RM 罗马数字的月份（I-XII ；I=JAN）（大写）
天 DAY 全长大写日期名（空白填充为9字符）
DY 缩写大写日期名（3字符）
DDD 一年里的日（001-366）
DD 一个月里的日（01-31）
D 一周里的日（1-7 ；周日是 1）
周 W 一个月里的周数（1-5）（第一周从该月第一天开始）
WW 一年里的周数（1-53）（第一周从该年的第一天开始）
IW ISO一年里的周数（第一个星期四在第一周里）
世纪 CC 世纪（2位）（21 世纪从 2001-01-01 开始）
儒略日 J 儒略日（自公元前 4712 年 1 月 1 日来的天数）
季度 Q 季度

时间和日期处理函数和操作符 - 图5 说明：

上表中RR计算年的规则如下：

  • 输入的两位年份在00~49之间： 当前年份的后两位在00~49之间，返回值年份的前两位和当前年份的前两位相同； 当前年份的后两位在50~99之间，返回值年份的前两位是当前年份的前两位加1。
  • 输入的两位年份在50~99之间： 当前年份的后两位在00~49之间，返回值年份的前两位是当前年份的前两位减1； 当前年份的后两位在50~99之间，返回值年份的前两位和当前年份的前两位相同。