PostgreSQL常用函数

PostgreSQL常用函数

内置函数

PostgreSQL 内置函数也称为聚合函数，用于对字符串或数字数据执行处理。

下面是所有通用 PostgreSQL 内置函数的列表：

• COUNT 函数：用于计算数据库表中的行数。
• MAX 函数：用于查询某一特定列中最大值。
• MIN 函数：用于查询某一特定列中最小值。
• AVG 函数：用于计算某一特定列中平均值。
• SUM 函数：用于计算数字列所有值的总和。
• ARRAY 函数：用于输入值(包括null)添加到数组中。
• Numeric 函数：完整列出一个 SQL 中所需的操作数的函数。
• String 函数：完整列出一个 SQL 中所需的操作字符的函数。

时间/日期函数

时间/日期操作符

下表演示了基本算术操作符的行为(+,*, 等)：

操作符	例子	结果
+	date '2001-09-28' + integer '7'	date '2001-10-05'
+	date '2001-09-28' + interval '1 hour'	timestamp '2001-09-28 01:00:00'
+	date '2001-09-28' + time '03:00'	timestamp '2001-09-28 03:00:00'
+	interval '1 day' + interval '1 hour'	interval '1 day 01:00:00'
+	timestamp '2001-09-28 01:00' + interval '23 hours'	timestamp '2001-09-29 00:00:00'
+	time '01:00' + interval '3 hours'	time '04:00:00'
-	- interval '23 hours'	interval '-23:00:00'
-	date '2001-10-01' - date '2001-09-28'	integer '3' (days)
-	date '2001-10-01' - integer '7'	date '2001-09-24'
-	date '2001-09-28' - interval '1 hour'	timestamp '2001-09-27 23:00:00'
-	time '05:00' - time '03:00'	interval '02:00:00'
-	time '05:00' - interval '2 hours'	time '03:00:00'
-	timestamp '2001-09-28 23:00' - interval '23 hours'	timestamp '2001-09-28 00:00:00'
-	interval '1 day' - interval '1 hour'	interval '1 day -01:00:00'
-	timestamp '2001-09-29 03:00' - timestamp '2001-09-27 12:00'	interval '1 day 15:00:00'
*	900 * interval '1 second'	interval '00:15:00'
*	21 * interval '1 day'	interval '21 days'
*	double precision '3.5' * interval '1 hour'	interval '03:30:00'
/	interval '1 hour' / double precision '1.5'	interval '00:40:00'

日期/时间函数

函数	返回类型	描述	例子	结果
age(timestamp, timestamp)	interval	减去参数后的"符号化"结果，使用年和月，不只是使用天	age(timestamp '2001-04-10', timestamp '1957-06-13')	43 years 9 mons 27 days
age(timestamp)	interval	从current_date减去参数后的结果（在午夜）	age(timestamp '1957-06-13')	43 years 8 mons 3 days
clock_timestamp()	timestamp with time zone	实时时钟的当前时间戳（在语句执行时变化）
current_date	date	当前的日期；
current_time	time with time zone	当日时间；
current_timestamp	timestamp with time zone	当前事务开始时的时间戳；
date_part(text, timestamp)	double precision	获取子域(等效于extract)；	date_part('hour', timestamp '2001-02-16 20:38:40')	20
date_part(text, interval)	double precision	获取子域(等效于extract)；	date_part('month', interval '2 years 3 months')	3
date_trunc(text, timestamp)	timestamp	截断成指定的精度；	date_trunc('hour', timestamp '2001-02-16 20:38:40')	2001-02-16 20:00:00
date_trunc(text, interval)	interval	截取指定的精度，	date_trunc('hour', interval '2 days 3 hours 40 minutes')	2 days 03:00:00
extract(field from timestamp)	double precision	获取子域；	extract(hour from timestamp '2001-02-16 20:38:40')	20
extract(field from interval)	double precision	获取子域；	extract(month from interval '2 years 3 months')	3
isfinite(date)	boolean	测试是否为有穷日期(不是 +/-无穷)	isfinite(date '2001-02-16')	true
isfinite(timestamp)	boolean	测试是否为有穷时间戳(不是 +/-无穷)	isfinite(timestamp '2001-02-16 21:28:30')	true
isfinite(interval)	boolean	测试是否为有穷时间间隔	isfinite(interval '4 hours')	true
justify_days(interval)	interval	按照每月 30 天调整时间间隔	justify_days(interval '35 days')	1 mon 5 days
justify_hours(interval)	interval	按照每天 24 小时调整时间间隔	justify_hours(interval '27 hours')	1 day 03:00:00
justify_interval(interval)	interval	使用justify_days和justify_hours调整时间间隔的同时进行正负号调整	justify_interval(interval '1 mon -1 hour')	29 days 23:00:00
localtime	time	当日时间；
localtimestamp	timestamp	当前事务开始时的时间戳；
make_date(year int, month int, day int)	date	为年、月和日字段创建日期	make_date(2013, 7, 15)	2013-07-15
make_interval(years int DEFAULT 0, months int DEFAULT 0, weeks int DEFAULT 0, days int DEFAULT 0, hours int DEFAULT 0, mins int DEFAULT 0, secs double precision DEFAULT 0.0)	interval	从年、月、周、天、小时、分钟和秒字段中创建间隔	make_interval(days := 10)	10 days
make_time(hour int, min int, sec double precision)	time	从小时、分钟和秒字段中创建时间	make_time(8, 15, 23.5)	08:15:23.5
make_timestamp(year int, month int, day int, hour int, min int, sec double precision)	timestamp	从年、月、日、小时、分钟和秒字段中创建时间戳	make_timestamp(2013, 7, 15, 8, 15, 23.5)	2013-07-15 08:15:23.5
make_timestamptz(year int, month int, day int, hour int, min int, sec double precision, [ timezone text ])	timestamp with time zone	从年、月、日、小时、分钟和秒字段中创建带有时区的时间戳。 没有指定timezone时，使用当前的时区。	make_timestamptz(2013, 7, 15, 8, 15, 23.5)	2013-07-15 08:15:23.5+01
now()	timestamp with time zone	当前事务开始时的时间戳；
statement_timestamp()	timestamp with time zone	实时时钟的当前时间戳；
timeofday()	text	与clock_timestamp相同，但结果是一个text 字符串；
transaction_timestamp()	timestamp with time zone	当前事务开始时的时间戳；

字符串/日期相互格式化函数

函数	返回类型	描述	例子
to_char(timestamp, text)	text	把时间戳转换成字串	to_char(current_timestamp, ‘HH12:MI:SS’)
to_char(interval, text)	text	把时间间隔转为字串	to_char(interval ‘15h 2m 12s’, ‘HH24:MI:SS’)
to_char(int, text)	text	把整数转换成字串	to_char(125, ‘999’)
to_char(double precision, text)	text	把实数/双精度数转换成字串	to_char(125.8::real, ‘999D9’)
to_char(numeric, text)	text	把numeric转换成字串	to_char(-125.8, ‘999D99S’)
to_date(text, text)	date	把字串转换成日期	to_date(‘05 Dec 2000’, ‘DD Mon YYYY’)
to_timestamp(text, text)	timestamp	把字串转换成时间戳	to_timestamp(‘05 Dec 2000’, ‘DD Mon YYYY’)
to_timestamp(double)	timestamp	把UNIX纪元转换成时间戳	to_timestamp(200120400)
to_number(text, text)	numeric	把字串转换成numeric	to_number(‘12,454.8-’, ‘99G999D9S’)

日期/时间格式化的占位符

占位符	描述
HH	一天的小时数(01-12)
HH12	一天的小时数(01-12)
HH24	一天的小时数(00-23)
MI	分钟(00-59)
SS	秒(00-59)
MS	毫秒(000-999)
US	微秒(000000-999999)
AM	正午标识(大写)
Y,YYY	带逗号的年(4和更多位)
YYYY	年(4和更多位)
YYY	年的后三位
YY	年的后两位
Y	年的最后一位
MONTH	全长大写月份名(空白填充为9字符)
Month	全长混合大小写月份名(空白填充为9字符)
month	全长小写月份名(空白填充为9字符)
MON	大写缩写月份名(3字符)
Mon	缩写混合大小写月份名(3字符)
mon	小写缩写月份名(3字符)
MM	月份号(01-12)
DAY	全长大写日期名(空白填充为9字符)
Day	全长混合大小写日期名(空白填充为9字符)
day	全长小写日期名(空白填充为9字符)
DY	缩写大写日期名(3字符)
Dy	缩写混合大小写日期名(3字符)dy缩写小写日期名(3字符)
DDD	一年里的日子(001-366)
DD	一个月里的日子(01-31)
D	一周里的日子(1-7；周日是1)
W	一个月里的周数(1-5)(第一周从该月第一天开始)
WW	一年里的周数(1-53)(第一周从该年的第一天开始)

数学函数

下面是PostgreSQL中提供的数学函数列表，需要说明的是，这些函数中有许多都存在多种形式，区别只是参数类型不同。除非特别指明，任何特定形式的函数都返回和它的参数相同的数据类型。

函数	返回类型	描述	例子	结果
abs(x)		绝对值	abs(-17.4)	17.4
cbrt(double)		立方根	cbrt(27.0)	3
ceil(double/numeric)		不小于参数的最小的整数	ceil(-42.8)	-42
degrees(double)		把弧度转为角度	degrees(0.5)	28.6478897565412
exp(double/numeric)		自然指数	exp(1.0)	2.71828182845905
floor(double/numeric)		不大于参数的最大整数	floor(-42.8)	-43
ln(double/numeric)		自然对数	ln(2.0)	0.693147180559945
log(double/numeric)		10为底的对数	log(100.0)	2
log(b numeric,x numeric)	numeric	指定底数的对数	log(2.0, 64.0)	6.0000000000
mod(y, x)		取余数	mod(9,4)	1
pi()	double	"π"常量	pi()	3.14159265358979
power(a double, b double)	double	求a的b次幂	power(9.0, 3.0)	729
power(a numeric, b numeric)	numeric	求a的b次幂	power(9.0, 3.0)	729
radians(double)	double	把角度转为弧度	radians(45.0)	0.785398163397448
random()	double	0.0到1.0之间的随机数值	random()
round(double/numeric)		圆整为最接近的整数	round(42.4)	42
round(v numeric, s int)	numeric	圆整为s位小数数字	round(42.438,2)	42.44
sign(double/numeric)		参数的符号(-1,0,+1)	sign(-8.4)	-1
sqrt(double/numeric)		平方根	sqrt(2.0)	1.4142135623731
trunc(double/numeric)		截断(向零靠近)	trunc(42.8)	42
trunc(v numeric, s int)	numeric	截断为s小数位置的数字	trunc(42.438,2)	42.43

三角函数

函数	描述
acos(x)	反余弦
asin(x)	反正弦
atan(x)	反正切
atan2(x, y)	正切 y/x 的反函数
cos(x)	余弦
cot(x)	余切
sin(x)	正弦
tan(x)	正切

字符串函数和操作符

下面是 PostgreSQL 中提供的字符串操作符列表：

函数	返回类型	描述	例子	结果
string 丨丨 string	text	字串连接	‘Post’ 丨丨 ‘greSQL’	PostgreSQL
bit_length(string)	int	字串里二进制位的个数	bit_length(‘jose’)	32
char_length(string)	int	字串中的字符个数	char_length(‘jose’)	4
convert(string using conversion_name)	text	使用指定的转换名字改变编码。	convert(‘PostgreSQL’ using iso_8859_1_to_utf8)	‘PostgreSQL’
lower(string)	text	把字串转化为小写	lower(‘TOM’)	tom
octet_length(string)	int	字串中的字节数	octet_length(‘jose’)	4
overlay(string placing string from int [for int])	text	替换子字串	overlay(‘Txxxxas’ placing ‘hom’ from 2 for 4)	Thomas
position(substring in string)	int	指定的子字串的位置	position(‘om’ in ‘Thomas’)	3
substring(string [from int] [for int])	text	抽取子字串	substring(‘Thomas’ from 2 for 3)	hom
substring(string from pattern)	text	抽取匹配 POSIX 正则表达式的子字串	substring(‘Thomas’ from ‘…$’)	mas
substring(string from pattern for escape)	text	抽取匹配SQL正则表达式的子字串	substring(‘Thomas’ from ‘%#“o_a#”_’ for ‘#’)	oma
trim([leading丨trailing 丨 both] [characters] from string)	text	从字串string的开头/结尾/两边/ 删除只包含characters(默认是一个空白)的最长的字串	trim(both ‘x’ from ‘xTomxx’)	Tom
upper(string)	text	把字串转化为大写。	upper(‘tom’)	TOM
ascii(text)	int	参数第一个字符的ASCII码	ascii(‘x’)	120
btrim(string text [, characters text])	text	从string开头和结尾删除只包含在characters里(默认是空白)的字符的最长字串	btrim(‘xyxtrimyyx’,‘xy’)	trim
chr(int)	text	给出ASCII码的字符	chr(65)	A
convert(string text, [src_encoding name,] dest_encoding name)	text	把字串转换为dest_encoding	convert( ‘text_in_utf8’, ‘UTF8’, ‘LATIN1’)	以ISO 8859-1编码表示的text_in_utf8
initcap(text)	text	把每个单词的第一个子母转为大写，其它的保留小写。单词是一系列字母数字组成的字符，用非字母数字分隔。	initcap(‘hi thomas’)	Hi Thomas
length(string text)	int	string中字符的数目	length(‘jose’)	4
lpad(string text, length int [, fill text])	text	通过填充字符fill(默认为空白)，把string填充为长度length。 如果string已经比length长则将其截断(在右边)。	lpad(‘hi’, 5, ‘xy’)	xyxhi
ltrim(string text [, characters text])	text	从字串string的开头删除只包含characters(默认是一个空白)的最长的字串。	ltrim(‘zzzytrim’,‘xyz’)	trim
md5(string text)	text	计算给出string的MD5散列，以十六进制返回结果。	md5(‘abc’)
repeat(string text, number int)	text	重复string number次。	repeat(‘Pg’, 4)	PgPgPgPg
replace(string text, from text, to text)	text	把字串string里出现地所有子字串from替换成子字串to。	replace(‘abcdefabcdef’, ‘cd’, ‘XX’)	abXXefabXXef
rpad(string text, length int [, fill text])	text	通过填充字符fill(默认为空白)，把string填充为长度length。如果string已经比length长则将其截断。	rpad(‘hi’, 5, ‘xy’)	hixyx
rtrim(string text [, character text])	text	从字串string的结尾删除只包含character(默认是个空白)的最长的字	rtrim(‘trimxxxx’,‘x’)	trim
split_part(string text, delimiter text, field int)	text	根据delimiter分隔string返回生成的第field个子字串(1 Base)。	split_part(‘abc@def@ghi’, ‘@’, 2)	def
strpos(string, substring)	text	声明的子字串的位置。	strpos(‘high’,‘ig’)	2
substr(string, from [, count])	text	抽取子字串。	substr(‘alphabet’, 3, 2)	ph
to_ascii(text [, encoding])	text	把text从其它编码转换为ASCII。	to_ascii(‘Karel’)	Karel
to_hex(number int/bigint)	text	把number转换成其对应地十六进制表现形式。	to_hex(9223372036854775807)	7fffffffffffffff
translate(string text, from text, to text)	text	把在string中包含的任何匹配from中的字符的字符转化为对应的在to中的字符。	translate(‘12345’, ‘14’, ‘ax’)	a23x5

类型转换相关函数

函数	返回类型	描述	实例
to_char(timestamp, text)	text	将时间戳转换为字符串	to_char(current_timestamp, ‘HH12:MI:SS’)
to_char(interval, text)	text	将时间间隔转换为字符串	to_char(interval ‘15h 2m 12s’, ‘HH24:MI:SS’)
to_char(int, text)	text	整型转换为字符串	to_char(125, ‘999’)
to_char(double precision, text)	text	双精度转换为字符串	to_char(125.8::real, ‘999D9’)
to_char(numeric, text)	text	数字转换为字符串	to_char(-125.8, ‘999D99S’)
to_date(text, text)	date	字符串转换为日期	to_date(‘05 Dec 2000’, ‘DD Mon YYYY’)
to_number(text, text)	numeric	转换字符串为数字	to_number(‘12,454.8-’, ‘99G999D9S’)
to_timestamp(text, text)	timestamp	转换为指定的时间格式 time zone convert string to time stamp	to_timestamp(‘05 Dec 2000’, ‘DD Mon YYYY’)
to_timestamp(double precision)	timestamp	把UNIX纪元转换成时间戳	to_timestamp(1284352323)