-
date_part date_part函数是在传统的Ingres函数的基础上制作的（该函数等效于SQL标准函数extract）： date_part('field', source) 这里的field参数必须是一个字符串，而不是一个名字。有效的field与extract一样，详细信息请参见EXTRACT。 示例： 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)
-
week(date[, mode]) 描述：根据模式返回指定日期时间所处年份中对应的周数，默认模式为0。 返回值类型：integer 表1 week函数中mode模式的工作原理 模式 一周的第一天 周数范围 第一周的判断规则 0 星期日 0-53 元旦后的第一个星期日所在周 1 星期一 0-53 元旦后有四天或者更多天所在周 2 星期日 1-53 元旦后的第一个星期日所在周 3 星期一 1-53 元旦后有四天或者更多天所在周 4 星期日 0-53 元旦后有四天或者更多天所在周 5 星期一 0-53 元旦后的第一个星期一所在周 6 星期日 1-53 元旦后有四天或者更多天所在周 7 星期一 1-53 元旦后的第一个星期一所在周 示例： 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23 select week('2018-01-01');
week
------
0
(1 row)
select week('2018-01-01', 0);
week
------
0
(1 row)
select week('2020-12-31', 1);
week
------
53
(1 row)
select week('2020-12-31', 5);
week
------
52
(1 row)
-
str_to_date(str, format) 描述：将日期/时间格式的字符串（str），按照所提供的显示格式（format）转换为日期类型的值。 返回值类型：timestamp 示例： 1
2
3
4
5
6
7
8
9
10 SELECT str_to_date('01,5,2021','%d,%m,%Y');
str_to_date
---------------------
2021-05-01 00:00:00
(1 row)
SELECT str_to_date('01,5,2021,09,30,17','%d,%m,%Y,%h,%i,%s');
str_to_date
---------------------
2021-05-01 09:30:17
(1 row)
适用于str_to_date的格式化输入的格式类型参考表1。这里仅支持“日期”格式、“日期+时间”格式的输入转换，对于仅“时间”格式的输入场景请使用str_to_time。
-
str_to_time(str, format) 描述：将时间格式的字符串（str），按照所提供的显示格式（format）转换为时间类型的值。 返回值类型：time 示例： 1
2
3
4
5 SELECT str_to_time('09:30:17','%h:%i:%s');
str_to_time
-------------
09:30:17
(1 row)
适用于str_to_time的格式化输入的格式类型参考表1，这里仅支持“时间”格式的输入转换，对于“日期”格式、“日期+时间”格式的输入场景请使用str_to_date。
-
yearweek(date[, mode]) 描述：返回给定日期date在本年中对应的年份和周数，周数范围为[1, 53]。 返回值类型：integer 示例： 1
2
3
4
5
6
7
8
9
10
11 select yearweek('2019-12-31');
yearweek
----------
201952
(1 row)
select yearweek('2019-1-1');
yearweek
----------
201852
(1 row)
-
time_format(time, fmt) 描述：time_format函数将日期参数按照fmt指定的格式转换为字符串。与date_format函数类似，但格式字符串只能包含小时、分钟、秒和微秒的格式说明符，如果包含其他说明符则会返回NULL值或0。 返回值类型：text 示例： 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15 SELECT time_format('2009-10-04 22:23:00', '%M %D %W');
time_format
--------------------
(1 row)
SELECT time_format('2021-02-20 08:30:45', '%Y-%m-%d %H:%i:%S');
time_format
---------------------
0000-00-00 08:30:45
(1 row)
SELECT time_format('2021-02-20 18:10:15', '%r-%T');
time_format
----------------------
06:10:15 PM-18:10:15
(1 row)
time_format仅支持时间相关的格式输出（%f、%H、%h、%I、%i、%k、%l、%p、%r、%S、%s、%T），不支持日期相关格式，其他情况处理为普通字符。
-
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)
-
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)
-
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)
-
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)
-
century 世纪。 第一个世纪从0001-01-01 00:00:00 AD开始。这个定义适用于所有使用阳历的国家。没有0世纪，直接从公元前1世纪到公元1世纪。 示例： 1
2
3
4
5 SELECT EXTRACT(CENTURY FROM TIMESTAMP '2000-12-16 12:21:13');
date_part
-----------
20
(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)
-
timeofday() 描述：当前日期及时间（像clock_timestamp，但是返回时为text。） 返回值类型：text 示例： 12345 SELECT timeofday(); timeofday ------------------------------------- Fri Sep 01 17:05:01.167506 2017
CS T(1 row)
-
from_unixtime(unix_timestamp[,format]) 描述：格式串缺省时，将unix时间戳转换为日期时间类型输出。格式串指定时，将unix时间戳转换为指定格式的字符串输出。 返回值类型：timestamp（格式串缺省）/ text（格式串指定） 示例： 1 2 3 4 5 6 7 8 910 SELECT from_unixtime(875996580); from_unixtime--------------------- 1997-10-04 20:23:00(1 row)SELECT from_unixtime(875996580, '%Y %D %M %h:%i:%s'); from_unixtime--------------------------- 1997 5th October 04:23:00(1 row)
-
unix_timestamp([timestamp with time zone]) 描述：获取从'1970-01-01 00:00:00'UTC到入参时间经历的秒数。无入参时，指定为当前时间。 返回值类型：bigint（无入参）/numeric（有入参） 示例： 12345 SELECT unix_timestamp(); unix_timestamp---------------- 1693906219(1 row) 12345 SELECT unix_timestamp('2018-09-08 12:11:13+06'); unix_timestamp---------------- 1536387073.000000(1 row)
