9.7. 数据类型格式化函数 #
PostgreSQL格式化函数提供一套强大的工具用于把各种数据类型(日期/时间、整数、浮点数、数值)转换成格式化的字符串以及反过来从格式化的字符串转换成指定的数据类型。表 9.20列出了这些函数。这些函数都遵循一个公共的调用规范:第一个参数是待格式化的值,而第二个是一个定义输出或输入格式的模板。
表 9.20. 格式化函数
| 函数 | 返回类型 | 描述 | 示例 |
|---|---|---|---|
| text | 将时间戳转换为字符串 | to_char(current_timestamp, 'HH12:MI:SS') |
| text | 将时间间隔转换为字符串 | to_char(interval '15h 2m 12s', 'HH24:MI:SS') |
| text | 将整数转换为字符串 | to_char(125, '999') |
| text | 将实数/double precision 转换为字符串 | to_char(125.8::real, '999D9') |
| text | 将 numeric 转换为字符串 | to_char(-125.8, '999D99S') |
| date | 将字符串转换为日期 | to_date('05 Dec 2000', 'DD Mon YYYY') |
| timestamp | 将字符串转换为时间戳 | to_timestamp('05 Dec 2000', 'DD Mon YYYY') |
| numeric | 将字符串转换为 numeric | to_number('12,454.8-', '99G999D9S') |
警告:已被废弃,不应在新编写的代码中使用。它将在下一个版本中被移除。
to_char(interval, text)
在一个输出模板串(对to_char)中,一些特定的模式会被识别,并被替换成来自待格式化值的、格式恰当的数据。任何不属于模板模式的文本都简单地照字面拷贝。同样,在一个输入模板串里(对除to_char以外的函数),模板模式标识输入数据串中要查看的部分以及要在其中找到的值。
表 9.21展示了可以用于格式化日期和时间值的模板模式。
表 9.21. 用于日期/时间格式化的模板模式
| 模式 | 描述 |
|---|---|
HH | 一天中的小时(01-12) |
HH12 | 一天中的小时(01-12) |
HH24 | 一天中的小时(00-23) |
MI | 指定位置的负号(如果数字 < 0) |
SS | 秒(00-59) |
MS | 毫秒(000-999) |
US | 微秒(000000-999999) |
SSSS | 自午夜起的秒数(0-86399) |
AM, A.M.,
PM 或 P.M. | 大写形式的上午/下午指示符 |
am, a.m.,
pm 或 p.m. | 小写形式的上午/下午指示符 |
Y,YYY | 带逗号的年(4 位或者更多位) |
YYYY | 年(4 位或者更多位) |
YYY | 年的最后 3 位数字 |
YY | 年的最后 2 位数字 |
Y | 年的最后 1 位数字 |
BC, B.C.,
AD 或 A.D. | 大写形式的纪元指示符 |
bc, b.c.,
ad 或 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) |
DD | 月内日序数(01-31) |
D | 一周中的日(1-7;周日是 1) |
W | 月内周序数(1-5)(第一周从该月第一天开始) |
WW | 一年中的第几周(1-53)(第一周从该年第一天开始) |
IW | ISO 一年中的第几周(该年的第一个星期四位于第 1 周) |
CC | 世纪(2 位数) |
J | 儒略日(自公元前 4712 年 1 月 1 日以来的天数) |
Q | 季度 |
RM | 以大写罗马数字表示的月份(I-XII;I=一月) |
rm | 以小写罗马数字表示的月份(i-xii;i=一月) |
TZ | 大写形式的时区名称 |
tz | 小写形式的时区名称 |
修饰符可以被应用于模板模式来修改它们的行为。例如,FMMonth就是带着FM修饰符的Month模式。表 9.22展示了可用于日期/时间格式化的修饰符模式。
表 9.22. 用于日期/时间格式化的模板模式修饰符
| 修饰符 | 描述 | 示例 |
|---|---|---|
FM 前缀 | 填充模式(抑制填充的空格和零) | FMMonth |
TH 后缀 | 大写序数后缀 | DDTH |
th 后缀 | 小写序数后缀 | DDth |
FX 前缀 | 固定格式的全局选项(见用法说明) | FX Month DD Day |
SP 后缀 | 拼写模式(尚未实现) | DDSP |
日期/时间格式化的用法说明:
FM抑制前导零和尾随空白,否则它们会被添加进来使模式的输出具有固定宽度。如果不使用
FX选项,to_timestamp和to_date会跳过输入字符串中的多个连续空格。FX必须指定为模板中的第一项。例如to_timestamp('2000 JUN', 'YYYY MON')是正确的,但to_timestamp('2000 JUN', 'FXYYYY MON')返回一个错误,因为to_timestamp只要求一个空格。to_char模板中允许有普通文本,它们会按字面输出。可以把一个子串放在双引号中,强制把它解释为字面文本,即使它包含模式关键字。例如,在'"Hello Year "YYYY'中,YYYY会被年份数据替换,但Year中单个的Y不会被替换。如果想在输出中出现双引号,必须在它前面加一个反斜杠,例如
'\\"YYYY Month\\"'。(需要两个反斜杠,因为反斜杠在字符串常量中已经具有特殊含义。)如果使用多于 4 位数字的年份,从字符串到
timestamp或date的YYYY转换有一个限制:必须在YYYY之后使用某个非数字字符或模板,否则年份总是被解释为 4 位数字。例如(年份为 20000 时):to_date('200001131', 'YYYYMMDD')会被解释为 4 位年份;应在年份后使用非数字分隔符,例如to_date('20000-1131', 'YYYY-MMDD')或to_date('20000Nov31', 'YYYYMonDD')。在从字符串到
timestamp的转换中,毫秒(MS)和微秒(US)值被用作小数点后秒的一部分。例如to_timestamp('12:3', 'SS:MS')不是 3 毫秒,而是 300,因为转换把它算作 12 + 0.3 秒。这意味着对于SS:MS格式,输入值12:3、12:30和12:300指定的毫秒数相同。要得到三毫秒,必须使用12:003,转换把它算作 12 + 0.003 = 12.003 秒。下面是一个更复杂的例子:
to_timestamp('15:12:02.020.001230', 'HH:MI:SS.MS.US')是 15 小时 12 分 2 秒 + 20 毫秒 + 1230 微秒 = 2.021230 秒。
表 9.23展示了可以用于格式化数值的模板模式。
表 9.23. 用于数值格式化的模板模式
| 模式 | 描述 |
|---|---|
9 | 具有指定位数的值 |
0 | 带前导零的值 |
.(句点) | 小数点 |
,(逗号) | 分组(千位)分隔符 |
PR | 尖括号内的负值 |
S | 紧贴数值的正负号(使用区域设置) |
L | 货币符号(使用区域设置) |
D | 小数点(使用区域设置) |
G | 分组分隔符(使用区域设置) |
MI | 分钟(00-59) |
PL | 在指定位置的正号(如果数字 > 0) |
SG | 在指定位置的正/负号 |
RN | 罗马数字(输入在 1 和 3999 之间) |
TH or th | 序数后缀 |
V | 移动指定位数(参阅注解) |
EEEE | 科学记数法(未实现) |
数字格式化的用法说明:
使用
SG、PL或MI格式化的符号不锚定到数字;例如to_char(-12, 'S9999')产生' -12',而to_char(-12, 'MI9999')产生'- 12'。Oracle 实现不允许在9前面使用MI,而是要求9在MI之前。9产生一个位数与9的个数相同的值。如果没有可用数字,则输出一个空格。TH不转换小于零的值,也不转换小数。PL、SG和TH是 PostgreSQL 扩展。V实际上把输入值乘以10^,其中nn是V后面的数字个数。to_char不支持V与小数点组合使用。(例如,不允许99.9V99。)
表 9.24展示了一些使用to_char函数的示例。
表 9.24. 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' |