9.8. 数据类型格式化函数

PostgreSQL格式化函数提供一套有效的工具用于把各 种数据类型转换成格式化的字符串以及反过来从格式化的字符串转换成指定的数据类型。 表 9-20列出了这些函数。 这些函数都遵循一个公共的调用习惯:第一个参数是待格式化的值, 而第二个是定义输出或输入格式的模板。

单参数to_timestamp函数也可以使用;它接受一个double precision 参数,并且从Unix纪元(秒自1970-01-01 00:00:00+00)转换为timestamp with time zone 类型。(Integer类型的Unix纪元隐含的转换为double precision类型。)

表 9-20. 格式化函数

函数返回类型描述例子
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 with time zone把字符串转换成时间戳to_timestamp('05 Dec 2000', 'DD Mon YYYY')
to_timestamp(double precision)timestamp with time zone把 Unix 纪元转换成时间戳to_timestamp(1284352323)

to_char输出模板字符串里,该函数族可以识别一些特定的模式, 并且把给定的数值正确地格式化成相应的数据。任何不属于模板模式的文本都简单地逐字拷贝。 同样,在一个输入模板字符串里(对其他函数),模板模式标识数值由输入数据字符串提供。

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

表 9-21. 用于日期/时间格式化的模式

模式描述
HH一天的小时数(01-12)
HH12一天的小时数(01-12)
HH24一天的小时数(00-23)
MI分钟(00-59)
SS秒(00-59)
MS毫秒(000-999)
US微秒(000000-999999)
SSSS午夜后的秒(0-86399)
AM, am, PMpm正午指示器(没有周期)
A.M., a.m., P.M.p.m.正午指示器(有周期)
Y,YYY带逗号的年(4 和更多位)
YYYY年(4 和更多位)
YYY年的后三位
YY年的后两位
Y年的最后一位
IYYYISO年(4 位或更多位)
IYYISO年的最后三位
IYISO年的最后两位
IISO年的最后一位
BC, bc, ADad纪元标识(没有周期)
B.C., b.c., A.D.a.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)
IDDDISO一年里的日(001-371;年的第一天是第一个ISO周的星期一)
DD一个月里的日(01-31)
D一周里的日,星期日(1)到星期六(7
IDISO一周里的日,星期一(1)到星期日(7
W一个月里的周数(1-5)(第一周从该月第一天开始)
WW一年里的周数(1-53)(第一周从该年的第一天开始)
IWISO一年里的周数(01-53;第一个星期四在第一周里)
CC世纪(2 位)(20 世纪从 2001-01-01 开始)
J儒略日(自公元前 4714 年 11 月 24日午夜来的天数)
Q季度(to_dateto_timestamp忽略此项)
RM罗马数字的月份(I-XII ;I=January)(大写)
rm罗马数字的月份(i-xii ;i=January)(小写)
TZ时区名(大写)
tz时区名(小写)

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

表 9-22. 日期/时间格式化的模板模式修饰词

修饰词描述例子
FM 前缀填充模式(抑制填充空白和尾随零)FMMonth
TH 后缀大写顺序数后缀DDTH, 例如, 12TH
th 后缀小写顺序数后缀DDth, 例如, 12th
FX 前缀固定格式全局选项(见用法须知)FX Month DD Day
TM 前缀翻译模式(基于lc_time显示本地化的日期和月份名)TMMonth
SP 后缀拼写模式(未实现)DDSP

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

表 9-23显示了用于数值格式化的模板模式。

表 9-23. 数值格式化的模版模式

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

数字格式化的用法须知:

一定的修饰符可以应用于任何模板模式来改变其行为。例如,FM99999999模式和FM修饰符。 表 9-24显示了数字格式的修饰符模式。

表 9-24. 数字格式的模板模式修饰符

修饰符描述示例
FM 前缀填充模式 (抑制填充空白和尾随零)FM9999
TH 后缀大写顺序数后缀999TH
th 后缀小写顺序数后缀999th

表 9-25显示了一些 to_char函数的用法。

表 9-25. to_char 示例

表达式结果
to_char(current_timestamp, 'Day, DD  HH12:MI:SS')'Tuesday  , 06  05:39:18'
to_char(current_timestamp, '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, 'FM999.999')'148.5'
to_char(148.5, 'FM999.990')'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, 'FM999MI')'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'
to_char(0.0004859, '9.99EEEE')' 4.86e-04'