pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。
PostgreSQL格式化函数提供一套强大的工具用于把各种数据类型 （日期/时间、整数、浮点数、数值） 转换成格式化的字符串以及反过来从格式化的字符串转换成 指定的数据类型。表 6.12列出了这些函数。这些函数都遵循一个公共的调用规范： 第一个参数是待格式化的值，而第二个是一个定义输出或输入格式的模板。
表 6.12. 格式化函数
| 函数 | 返回类型 | 描述 | 示例 |
|---|---|---|---|
to_char(timestamp, text) |
text |
将时间戳转换为字符串 | to_char(timestamp 'now','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 |
将实数/double precision 转换为字符串 | to_char(125.8,'999D9') |
to_char(numeric, text) |
text |
将 numeric 转换为字符串 | to_char(numeric '-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_number(text, text) |
numeric |
将字符串转换为 numeric | to_number('12,454.8-', '99G999D9S') |
在输出模板字符串中，有一些特定的模式会被 识别，并被替换为来自待格式化值的、格式恰当的数据。 任何不是模板模式的文本都 简单地按字面复制。类似地，在输入模板字符串中，模板模式 标识要查看的输入数据字符串的部分以及 要在其中找到的值。
表 6.13展示了可以用于格式化日期和时间值的模板模式。
表 6.13. 用于日期/时间转换的模板模式
| 模式 | 描述 |
|---|---|
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, 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；SUN=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” 模式。 表 6.14 展示了 日期/时间格式化的 修饰符模式。
表 6.14. 用于日期/时间转换的模板模式修饰符
| 修饰符 | 描述 | 示例 |
|---|---|---|
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 只要求一个空格。
如果想在字符串常量中使用反斜杠（“\”）， 必须输入双反斜杠（“\\”）； 例如 '\\HH\\MI\\SS'。对 PostgreSQL 中的任何字符串常量都是 如此。
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')。
在从字符串到时间戳的转换中， 毫秒 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 秒。
表 6.15展示了可以用于格式化数值的模板模式。
表 6.15. 用于数值转换的模板模式
| 模式 | 描述 |
|---|---|
9 |
具有指定位数的值 |
0 |
带前导零的值 |
.（句点） |
小数点 |
,（逗号） |
分组（千位）分隔符 |
PR |
尖括号内的负值 |
S |
带负号的负值（使用区域设置） |
L |
货币符号（使用区域设置） |
D |
小数点（使用区域设置） |
G |
分组分隔符（使用区域设置） |
MI |
分钟（00-59） |
PL |
在指定位置的正号（如果数字 > 0） |
SG |
在指定位置的正/负号 |
RN |
罗马数字（输入在 1 和 3999 之间） |
TH or th |
转换为序数 |
V |
移动 n 位数字（参阅 注解） |
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。）
表 6.16展示了一些使用to_char函数的示例。
表 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' |
译文有误、术语不当或页面显示问题，请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题，请在当前版本的对应页面向上游反馈；上游不再修订已结束维护的版本。