↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1
历史版本。 PostgreSQL 7.3 已结束支持。 请参阅 当前版本手册.

6.7. 数据类型格式化函数 #

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将字符串转换为 numericto_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),第一周从该年的第一天开始
IWISO 一年中的第几周(该年的第一个星期四位于第 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^n,其中 n 是 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'

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.