6.7. 数据类型格式化函数

PostgreSQL 格式化函数提供一套有效的工具用于把各种数据类型 (日期/时间,integer,floating point,numeric) 转换成格式化的字符串以及反过来从格式化的字符串转换成 指定的数据类型。 Table 6-12 列出了这些函数。 这些函数都遵循一个公共的调用习惯: 第一个参数是待格式化的值,而第二个是一个定义输出格式的模板.

Table 6-12. 格式化函数

函数返回描述例子
to_char(timestamp, text)text把 timestamp 转换成 stringto_char(timestamp 'now','HH12:MI:SS')
to_char(int, text)text把整数转换成字串to_char(125, '999')
to_char(double precision, text)text把 real/double precision 转换成 stringto_char(125.8, '999D9')
to_char(numeric, text)text把 numeric 转换成 stringto_char(numeric '-125.8', '999D99S')
to_date(text, text)date把 string 转换成 dateto_date('05 Dec 2000', 'DD Mon YYYY')
to_timestamp(text, text)date把 string 转换成 timestampto_timestamp('05 Dec 2000', 'DD Mon YYYY')
to_number(text, text)numeric把 string 转换成 numericto_number('12,454.8-', '99G999D9S')

在输出模板字串里,该函数族可以识别一些特定的模式,并且 把待格式化的数值正确地格式化成相应的数据. 任何不属于模板模式的文本都简单地照字拷贝.同样,在一个输入 模板字串里,模板模式标识要查看的输入数据字串,并且将在该位置 寻找数值.

Table 6-13 显示了 可以用于格式化日期和时间值的模版。

Table 6-13. 用于 date/time 转换的模板

模板描述
HH一天的小时数 (01-12)
HH12一天的小时数 (01-12)
HH24一天的小时数 (00-23)
MI分钟 (00-59)
SS秒 (00-59)
MS毫秒 (000-999)
US微秒 (000000-999999)
SSSS午夜后的秒 (0-86399)
AMA.M.PMP.M.正午标识(大写)
ama.m.pmp.m.正午标识(小写)
Y,YYY带逗号的年(4 和更多位)
YYYY年(4和更多位)
YYY年的后三位
YY年的后两位
Y年的最后一位
BCB.C.ADA.D.年标识(大写)
bcb.c.ada.d.年标识(小写)
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;SUN=1)
W一个月里的周数(1-5),这里第一周从该月第一天开始
WW一年里的周数(1-53),这里的第一周从该年的第一天开始
IWISO 一年里的周数(第一个星期四在第一周里)
CC世纪(2 位)
JJulian 日期(自公元前4712年1月1日来的日期)
Q季度
RM罗马数字的月份(I-XII;I=JAN)-大写
rm罗马数字的月份(I-XII;I=JAN)-小写
TZ时区字串 - 大写
tz时区字串 - 小写

有一些修饰词可以应用于模板来修改它们的行为.比如, "FMMonth" 就是 带着 "FM" 前缀的 "Month" 模式. Table 6-14 显示了 用于日期/时间格式化的修饰词模式。

Table 6-14. 日期/时间转换的模板模式修饰词

修饰词描述例子
FM 前缀填充模式(抑制填充空白和零)FMMonth
TH 后缀大写顺序数后缀DDTH
th 后缀增加小写顺序数后缀DDth
FX 前缀固定格式全局选项(见用法须知)FX Month DD Day
SP suffix拼写模式(还未实现)DDSP

日期/时间格式化的用法须知:

Table 6-15 显示了 可以用于数值格式化的模版模式。

Table 6-15. 用于向数值转换的模板模式

模板描述
9带有指定数值位数的值
0带前导零的值
. (句点)小数点
, (逗号)分组(千)分隔符
PR尖括号内负值
S带负号的负值(使用区域设置)
L货币符号(使用区域设置)
D小数点(使用区域设置)
G分组分隔符(使用区域设置)
MI在指明的位置的负号(如果数字 < 0)
PL在指明的位置的正号(如果数字 > 0)
SG在指明的位置的正/负号
RN罗马数字(输入在 1 和 3999 之间)
THth转换成序数
V移动 n 位(小数)(参阅注解)
EEEE科学记数。(现在还未实现)

数字格式化的用法须知:

Table 6-16 显示了 一些使用 to_char 函数的用法。

Table 6-16. to_char 例子

输入输出
to_char(now(),'Day, DD HH12:MI:SS')'Tuesday , 06 05:39:18'
to_char(now(),'FMDay, FMDD HH12:MI:SS')'Tuesday, 6 05:39:18'
to_char(-0.1,'99.99')' -.10'
to_char(-0.1,'FM9.99')'-.1'
to_char(0.1,'0.9')' 0.1'
to_char(12,'9990999.9')' 0012.0'
to_char(12,'FM9990999.9')'0012'
to_char(485,'999')' 485'
to_char(-485,'999')'-485'
to_char(485,'9 9 9')' 4 8 5'
to_char(1485,'9,999')' 1,485'
to_char(1485,'9G999')' 1 485'
to_char(148.5,'999.999')' 148.500'
to_char(148.5,'999D999')' 148,500'
to_char(3148.5,'9G999D999')' 3 148,500'
to_char(-485,'999S')'485-'
to_char(-485,'999MI')'485-'
to_char(485,'999MI')'485'
to_char(485,'PL999')'+485'
to_char(485,'SG999')'+485'
to_char(-485,'SG999')'-485'
to_char(-485,'9SG99')'4-85'
to_char(-485,'999PR')'<485>'
to_char(485,'L999')'DM 485
to_char(485,'RN')' CDLXXXV'
to_char(485,'FMRN')'CDLXXXV'
to_char(5.2,'FMRN')V
to_char(482,'999th')' 482nd'
to_char(485, '"Good number:"999')'Good number: 485'
to_char(485.8,'"Pre:"999" Post:" .999')'Pre: 485 Post: .800'
to_char(12,'99V999')' 12000'
to_char(12.4,'99V999')' 12400'
to_char(12.45, '99V9')' 125'