pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。
由 Karel Zak（<zakkr@zf.jcu.cz>）于 2000-01-24 编写
Postgres 格式化函数提供了一套强大的工具，用于把各种数据类型（日期/时间、整数、浮点、numeric）转换为 格式化的字符串以及把格式化的字符串转换回原始的数据类型。这些函数都 使用一个公共的调用约定：第一个参数是要格式化的值，第二个参数是定义 输出或输入格式的模板。
表 4.9. 格式化函数
| 函数 | 返回 | 描述 | 例子 |
|---|---|---|---|
| to_char(timestamp, text) | text | 把 timestamp 转换为字符串 | to_char(timestamp 'now','HH12:MI:SS') |
| to_char(int, text) | text | 把 int4/int8 转换为字符串 | to_char(125, '999') |
| to_char(double precision, text) | text | 把 real/double precision 转换为字符串 | to_char(125.8, '999D9') |
| to_char(numeric, text) | text | 把 numeric 转换为字符串 | to_char(numeric '-125.8', '999D99S') |
| to_date(text, text) | date | 把字符串转换为 date | to_date('05 Dec 2000', 'DD Mon YYYY') |
| to_timestamp(text, text) | timestamp | 把字符串转换为 timestamp | to_timestamp('05 Dec 2000', 'DD Mon YYYY') |
| to_number(text, text) | numeric | 把字符串转换为 numeric | to_number('12,454.8-', '99G999D9S') |
在输出模板字符串中，有一些特定的模式会被 识别，并被替换为来自待格式化值的、格式恰当的数据。 任何不是模板模式的文本都 简单地按字面复制。同样，在输入模板字符串中，模板模式 标识要查看的输入数据字符串的部分以及 要在其中找到的值。
表 4.10. 用于日期/时间转换的模板模式
| 模式 | 描述 |
|---|---|
| HH | 小时（01-12） |
| HH12 | 小时（01-12） |
| HH24 | 小时（00-23） |
| MI | 分钟（00-59） |
| SS | 秒（00-59） |
| SSSS | 自午夜以来的秒数（0-86399） |
| AM or A.M. or PM or P.M. | 大写形式的上午/下午指示符 |
| am or a.m. or pm or p.m. | 小写形式的上午/下午指示符 |
| Y,YYY | 年份（4 位或更多数字）带逗号 |
| YYYY | 年份（4 位或更多数字） |
| YYY | 年份的最后 3 位数字 |
| YY | 年份的最后 2 位数字 |
| Y | 年份的最后一位数字 |
| BC or B.C. or AD or A.D. | 大写形式的纪元指示符 |
| bc or b.c. or ad or 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” 模式。
表 4.11. 用于日期/时间转换的模板模式修饰符
| 修饰符 | 描述 | 例子 |
|---|---|---|
FM prefix |
填充模式（抑制填充的空白和零） | FMMonth |
TH suffix |
添加大写序数后缀 | DDTH |
th suffix |
添加小写序数后缀 | DDth |
FX prefix |
固定格式全局选项（见下文） | FX Month DD Day |
SP suffix |
拼写模式（尚未实现） | 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')。
表 4.12. 用于数值转换的模板模式
| 模式 | 描述 |
|---|---|
| 9 | 具有指定位数的值 |
| 0 | 带前导零的值 |
| . (period) | 小数点 |
| , (comma) | 组（千位）分隔符 |
| PR | 尖括号中的负值 |
| S | 带负号的负值（使用区域设置） |
| L | 货币符号（使用区域设置） |
| D | 小数点（使用区域设置） |
| G | 组分隔符（使用区域设置） |
| MI | 指定位置上的负号（若数字 < 0） |
| 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 是 Postgres 扩展。
V 实际上把输入值乘以 10^，其中 nn 是 V 后面的数字个数。
表 4.13. 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 报告译文问题。 英文原文本身的问题，请在当前版本的对应页面向上游反馈；上游不再修订已结束维护的版本。