PostgreSQL 格式化函数提供了一组强大的工具,用于将各种数据类型(日期/时间、整数、浮点数、数值)转换为格式化字符串,以及将格式化字符串转换为特定的数据类型。 表 9.26 列出了这些函数。这些函数都遵循一个通用的调用约定:第一个参数是要格式化的值,第二个参数是定义输出或输入格式的模板。
表 9.26. 格式化函数
函数 描述 示例 |
---|
根据给定的格式将时间戳转换为字符串。
|
根据给定的格式将时间间隔转换为字符串。
|
根据给定的格式将数字转换为字符串;适用于
|
根据给定的格式将字符串转换为日期。
|
根据给定的格式将字符串转换为数值。
|
根据给定的格式将字符串转换为时间戳。(另请参见表 9.33中的
|
to_timestamp
和 to_date
的存在是为了处理无法通过简单类型转换转换的输入格式。对于大多数标准日期/时间格式,只需将源字符串转换为所需的数据类型即可,而且更容易。同样,to_number
对于标准数字表示是不必要的。
在 to_char
输出模板字符串中,有一些模式会被识别并根据给定的值替换为适当格式的数据。任何不是模板模式的文本都会被简单地逐字复制。类似地,在输入模板字符串(用于其他函数)中,模板模式标识要由输入数据字符串提供的值。如果模板字符串中有不是模板模式的字符,则输入数据字符串中对应的字符会被简单地跳过(无论它们是否等于模板字符串字符)。
表 9.27 显示了可用于格式化日期和时间值的模板模式。
表 9.27. 日期/时间格式的模板模式
模式 | 描述 |
---|---|
HH |
一天中的小时 (01–12) |
HH12 |
一天中的小时 (01–12) |
HH24 |
一天中的小时 (00–23) |
MI |
分钟 (00–59) |
SS |
秒 (00–59) |
MS |
毫秒 (000–999) |
US |
微秒 (000000–999999) |
FF1 |
十分之一秒 (0–9) |
FF2 |
百分之一秒 (00–99) |
FF3 |
毫秒 (000–999) |
FF4 |
十分之一毫秒 (0000–9999) |
FF5 |
百分之一毫秒 (00000–99999) |
FF6 |
微秒 (000000–999999) |
SSSS , SSSSS |
午夜之后的秒数 (0–86399) |
AM 、am 、PM 或 pm |
子午线指示符(不带句点) |
A.M. 、a.m. 、P.M. 或 p.m. |
子午线指示符(带句点) |
Y,YYY |
带逗号的年份(4 位或更多位数) |
YYYY |
年份(4 位或更多位数) |
YYY |
年份的最后 3 位数字 |
YY |
年份的最后 2 位数字 |
Y |
年份的最后 1 位数字 |
IYYY |
ISO 8601 周编号年份(4 位或更多位数) |
IYY |
ISO 8601 周编号年份的最后 3 位数字 |
IY |
ISO 8601 周编号年份的最后 2 位数字 |
I |
ISO 8601 周编号年份的最后 1 位数字 |
BC 、bc 、AD 或 ad |
纪元指示符(不带句点) |
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) |
IDDD |
ISO 8601 周编号年份中的第几天 (001–371;该年的第 1 天是第一个 ISO 周的星期一) |
DD |
一个月中的第几天 (01–31) |
D |
星期几,星期日 (1 ) 到星期六 (7 ) |
ID |
ISO 8601 星期几,星期一 (1 ) 到星期日 (7 ) |
W |
一个月中的第几周 (1–5)(第一周从该月的第一天开始) |
WW |
一年中的第几周 (1–53)(第一周从该年的第一天开始) |
IW |
ISO 8601 周编号年份中的第几周 (01–53;该年的第一个星期四在第 1 周) |
CC |
世纪(2 位数字)(21 世纪从 2001-01-01 开始) |
J |
儒略日(自公元前 4714 年 11 月 24 日当地午夜起的整数天数;请参阅第 B.7 节) |
Q |
季度 |
RM |
月份,使用大写罗马数字表示(I–XII;I=一月) |
rm |
月份,使用小写罗马数字表示(i–xii;i=一月) |
TZ |
大写时区缩写 |
tz |
小写时区缩写 |
TZH |
时区小时数 |
TZM |
时区分钟数 |
OF |
与 UTC 的时区偏移量(HH 或 HH : MM ) |
修饰符可以应用于任何模板模式以更改其行为。例如,FMMonth
是带有 FM
修饰符的 Month
模式。表 9.28 显示了日期/时间格式的修饰符模式。
表 9.28. 日期/时间格式的模板模式修饰符
修饰符 | 描述 | 示例 |
---|---|---|
FM 前缀 |
填充模式(抑制前导零和填充空格) | FMMonth |
TH 后缀 |
大写序数后缀 | DDTH ,例如,12TH |
th 后缀 |
小写序数后缀 | DDth ,例如,12th |
FX 前缀 |
固定格式全局选项(请参阅用法说明) | FX Month DD Day |
TM 前缀 |
翻译模式(使用基于 lc_time 的本地化日期和月份名称) | TMMonth |
SP 后缀 |
拼写模式(未实现) | DDSP |
日期/时间格式的用法说明
FM
抑制前导零和尾随空格,否则会添加这些零和空格以使模式的输出为固定宽度。在 PostgreSQL 中,FM
仅修改下一个规范,而在 Oracle 中,FM
影响所有后续规范,并且重复的 FM
修饰符会打开和关闭填充模式。
无论是否指定 FM
,TM
都会抑制尾随空格。
to_timestamp
和 to_date
忽略输入中的字母大小写;因此,例如 MON
、Mon
和 mon
都接受相同的字符串。当使用 TM
修饰符时,会根据函数的输入排序规则的规则进行大小写折叠(请参阅第 23.2 节)。
to_timestamp
和 to_date
会跳过输入字符串开头和日期和时间值周围的多个空格,除非使用 FX
选项。 例如,to_timestamp(' 2000 JUN', 'YYYY MON')
和 to_timestamp('2000 - JUN', 'YYYY-MON')
可以工作,但 to_timestamp('2000 JUN', 'FXYYYY MON')
会返回错误,因为 to_timestamp
期望只有一个空格。FX
必须在模板中指定为第一项。
除非使用 FX
选项,否则 to_timestamp
和 to_date
的模板字符串中的分隔符(空格或非字母/非数字字符)会匹配输入字符串中的任何单个分隔符或被跳过。 例如,to_timestamp('2000JUN', 'YYYY///MON')
和 to_timestamp('2000/JUN', 'YYYY MON')
可以工作,但 to_timestamp('2000//JUN', 'YYYY/MON')
返回错误,因为输入字符串中的分隔符数量超过了模板中的分隔符数量。
如果指定了 FX
,则模板字符串中的分隔符与输入字符串中的一个字符完全匹配。 但是请注意,输入字符串字符不需要与模板字符串中的分隔符相同。 例如,to_timestamp('2000/JUN', 'FXYYYY MON')
可以工作,但 to_timestamp('2000/JUN', 'FXYYYY MON')
返回错误,因为模板字符串中的第二个空格会消耗输入字符串中的字母 J
。
TZH
模板模式可以匹配带符号的数字。 如果没有 FX
选项,减号可能会产生歧义,并可能被解释为分隔符。 此歧义的解决方式如下:如果模板字符串中 TZH
之前的分隔符数量少于输入字符串中减号之前的分隔符数量,则减号将被解释为 TZH
的一部分。 否则,减号将被视为值之间的分隔符。 例如,to_timestamp('2000 -10', 'YYYY TZH')
将 -10
与 TZH
匹配,但 to_timestamp('2000 -10', 'YYYY TZH')
将 10
与 TZH
匹配。
普通文本允许在 to_char
模板中使用,并且会按字面量输出。 您可以将子字符串放在双引号中,以强制将其解释为字面文本,即使它包含模板模式。 例如,在 '"Hello Year "YYYY'
中,YYYY
将被年份数据替换,但 Year
中的单个 Y
不会被替换。 在 to_date
、to_number
和 to_timestamp
中,字面文本和双引号字符串会导致跳过字符串中包含的字符数;例如,"XX"
会跳过两个输入字符(无论它们是否是 XX
)。
在 PostgreSQL 12 之前,可以使用非字母或非数字字符跳过输入字符串中的任意文本。例如,to_timestamp('2000y6m1d', 'yyyy-MM-DD')
以前可以工作。现在,您只能为此目的使用字母字符。例如,to_timestamp('2000y6m1d', 'yyyytMMtDDt')
和 to_timestamp('2000y6m1d', 'yyyy"y"MM"m"DD"d"')
会跳过 y
、m
和 d
。
如果要在输出中包含双引号,则必须在其前面加上反斜杠,例如 '\"YYYY Month\"'
。 在双引号字符串之外,反斜杠没有其他特殊含义。 在双引号字符串内,反斜杠会导致下一个字符按字面量处理,无论它是什么(但这没有特殊效果,除非下一个字符是双引号或另一个反斜杠)。
在 to_timestamp
和 to_date
中,如果年份格式规范小于四位数字(例如 YYY
),并且提供的年份小于四位数字,则年份将被调整为最接近 2020 年的年份,例如,95
变为 1995 年。
在 to_timestamp
和 to_date
中,负数年份被视为表示公元前。 如果您同时写入负数年份和显式的 BC
字段,则会再次得到公元。 输入零年份被视为公元前 1 年。
在 to_timestamp
和 to_date
中,YYYY
转换在处理超过 4 位数字的年份时有限制。 您必须在 YYYY
之后使用一些非数字字符或模板,否则年份始终被解释为 4 位数字。 例如(年份为 20000):to_date('200001130', 'YYYYMMDD')
将被解释为 4 位数字的年份;而是在年份之后使用非数字分隔符,例如 to_date('20000-1130', 'YYYY-MMDD')
或 to_date('20000Nov30', 'YYYYMonDD')
。
在 to_timestamp
和 to_date
中,如果存在 YYY
、YYYY
或 Y,YYY
字段,则接受但忽略 CC
(世纪)字段。 如果 CC
与 YY
或 Y
一起使用,则结果将计算为指定世纪中的那一年。 如果指定了世纪但未指定年份,则假定为该世纪的第一年。
在 to_timestamp
和 to_date
中,接受工作日名称或数字(DAY
、D
和相关的字段类型),但在计算结果时会忽略它们。 对于季度(Q
)字段也是如此。
在 to_timestamp
和 to_date
中,ISO 8601 周编号日期(与公历日期不同)可以通过两种方式之一指定
年份、周数和工作日:例如,to_date('2006-42-4', 'IYYY-IW-ID')
返回日期 2006-10-19
。 如果省略工作日,则假定为 1(星期一)。
年份和一年中的某一天:例如,to_date('2006-291', 'IYYY-IDDD')
也返回 2006-10-19
。
尝试使用 ISO 8601 周编号字段和公历日期字段的混合来输入日期是无意义的,并且会导致错误。 在 ISO 8601 周编号年份的上下文中,“月”或“月中的某一天”的概念没有任何意义。 在公历年份的上下文中,ISO 周没有任何意义。
虽然 to_date
会拒绝公历和 ISO 周编号日期字段的混合,但 to_char
不会,因为诸如 YYYY-MM-DD (IYYY-IDDD)
之类的输出格式规范可能很有用。 但是,应避免编写类似 IYYY-MM-DD
的内容;这会在年初附近产生令人惊讶的结果。(有关更多信息,请参见 第 9.9.1 节。)
在 to_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', 'HH24:MI:SS.MS.US')
是 15 小时、12 分钟和 2 秒 + 20 毫秒 + 1230 微秒 = 2.021230 秒。
to_char(..., 'ID')
的星期几编号与 extract(isodow from ...)
函数匹配,但 to_char(..., 'D')
的星期几编号与 extract(dow from ...)
的星期几编号不匹配。
to_char(interval)
将 HH
和 HH12
格式化为 12 小时制时钟显示,例如,0 小时和 36 小时都输出为 12
,而 HH24
则输出完整的小时值,该值在 interval
值中可以超过 23。
表 9.29 显示了可用于格式化数值的模板模式。
表 9.29. 数值格式化的模板模式
模式 | 描述 |
---|---|
9 |
数字位置(如果无关紧要,可以删除) |
0 |
数字位置(即使无关紧要也不会删除) |
. (句点) |
小数点 |
, (逗号) |
分组(千位)分隔符 |
PR |
尖括号中的负值 |
S |
附加到数字的符号(使用区域设置) |
L |
货币符号(使用区域设置) |
D |
小数点(使用区域设置) |
G |
分组分隔符(使用区域设置) |
MI |
在指定位置的负号(如果数字 < 0) |
PL |
在指定位置的正号(如果数字 > 0) |
SG |
在指定位置的正/负号 |
RN |
罗马数字(输入介于 1 和 3999 之间) |
TH 或 th |
序数后缀 |
V |
移动指定位数的数字(参见注释) |
EEEE |
科学计数法的指数 |
数值格式化的使用说明
0
指定一个始终打印的数字位置,即使它包含前导/尾随零。9
也指定一个数字位置,但如果它是前导零,则会替换为空格;如果它是尾随零并且指定了填充模式,则会删除。(对于 to_number()
,这两个模式字符是等效的。)
如果格式提供的分数位数少于正在格式化的数字,to_char()
将把数字舍入到指定的分数位数。
模式字符 S
、L
、D
和 G
表示当前区域设置定义的符号、货币符号、小数点和千位分隔符(请参阅 lc_monetary 和 lc_numeric)。模式字符句点和逗号表示这些确切的字符,具有小数点和千位分隔符的含义,与区域设置无关。
如果在 to_char()
的模式中没有为符号明确设置,则将为符号保留一列,并且它将锚定到(出现在数字的左侧)数字。 如果 S
出现在某些 9
的左侧,它也将同样锚定到数字。
使用 SG
、PL
或 MI
格式化的符号不会锚定到数字;例如,to_char(-12, 'MI9999')
生成 '- 12'
,而 to_char(-12, 'S9999')
生成 ' -12'
。(Oracle 实现不允许在 9
之前使用 MI
,而是要求 9
在 MI
之前)。
TH
不会转换小于零的值,也不会转换小数。
PL
、SG
和 TH
是 PostgreSQL 的扩展。
在 to_number
中,如果使用非数据模板模式(如 L
或 TH
),则会跳过相应数量的输入字符,无论它们是否与模板模式匹配,除非它们是数据字符(即数字、符号、小数点或逗号)。例如,TH
将跳过两个非数据字符。
V
与 to_char
将输入值乘以 10^
,其中 n
n
是 V
后面的位数。 V
与 to_number
以类似的方式进行除法。 to_char
和 to_number
不支持将 V
与小数点结合使用(例如,不允许使用 99.9V99
)。
EEEE
(科学计数法)不能与除数字和小数点模式之外的任何其他格式化模式或修饰符结合使用,并且必须位于格式字符串的末尾(例如,9.99EEEE
是有效的模式)。
某些修饰符可以应用于任何模板模式以改变其行为。例如,FM99.99
是带有 FM
修饰符的 99.99
模式。 表 9.30 显示了数值格式化的修饰符模式。
表 9.30. 数值格式化的模板模式修饰符
修饰符 | 描述 | 示例 |
---|---|---|
FM 前缀 |
填充模式(抑制尾随零和填充空格) | FM99.99 |
TH 后缀 |
大写序数后缀 | 999TH |
th 后缀 |
小写序数后缀 | 999th |
表 9.31 显示了 to_char
函数的一些使用示例。
表 9.31. 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(current_timestamp AT TIME ZONE 'UTC', 'YYYY-MM-DD"T"HH24:MI:SS"Z"') |
'2022-12-06T05:39:18Z' , ISO8601 扩展格式 |
to_char(-0.1, '99.99') |
' -.10' |
to_char(-0.1, 'FM9.99') |
'-.1' |
to_char(-0.1, 'FM90.99') |
'-0.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' |
如果您发现文档中的任何内容不正确、与您使用特定功能的经验不符或需要进一步澄清,请使用此表单报告文档问题。