PostgreSQL 数据类型格式化函数
PostgreSQL格式化函数提供一套强大的工具用于把各种数据类型 (日期/时间、整数、浮点、数字) 转换成格式化的字符串以及反过来从格式化的字符串转换成 指定的数据类型。表 9.25列出了这些函数。这些函数都遵循一个公共的调用规范: 第一个参数是待格式化的值,而第二个是一个定义输出或输入格式的模板。
表 9.25. 格式化函数
提示
to_timestamp
和to_date
存在的目的是为了处理无法用简单造型转换的输入格式。对于大部分标准的日期/时间格式,简单地把源字符串造型成所需的数据类型是可以的,并且简单很多。类似地,对于标准的数字表示形式,to_number
也是没有必要的。
在一个to_char
输出模板串中,一些特定的模式可以被识别并且被替换成基于给定值的被恰当地格式化的数据。任何不属于模板模式的文本都简单地照字面拷贝。同样,在一个输入 模板串里(对其他函数),模板模式标识由输入数据串提供的值。如果在模板字符串中有不是模板模式的字符,输入数据字符串中的对应字符会被简单地跳过(不管它们是否等于模板字符串字符)。
表 9.26展示了可以用于格式化日期和时间值的模版。
表 9.26. 用于日期/时间格式化的模板模式
模式 | 描述 |
---|---|
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 or pm
|
正午指示器(不带句号) |
A.M. , a.m. , P.M. or p.m.
|
正午指示器(带句号) |
Y,YYY
|
带逗号的年(4 位或者更多位) with comma |
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; 新的一年的第一个周四在第一周) |
CC
|
世纪(2 位数)(21 世纪开始于 2001-01-01) |
J
|
儒略日(从午夜 UTC 的公元前 4714 年 11 月 24 日开始的整数日数) |
Q
|
季度 |
RM
|
大写形式的罗马计数法的月 (I–XII; I=一月) |
rm
|
小写形式的罗马计数法的月 (i–xii; i=一月) |
TZ
|
大写形式的时区缩写(仅在to_char 中支持) |
tz
|
小写形式的时区缩写(仅在to_char 中支持) |
TZH
|
时区的小时 |
TZM
|
时区的分钟 |
OF
|
从UTC开始的时区偏移(仅在to_char 中支持) |
修饰语可以被应用于模板模式来修改它们的行为。例如,FMMonth
就是带着FM
修饰语的Month
模式。表 9.27展示了可用于日期/时间格式化的修饰语模式。
表 9.27. 用于日期/时间格式化的模板模式修饰语
修饰语 | 描述 | 例子 |
---|---|---|
FM prefix |
填充模式(抑制前导零和填充的空格) | FMMonth
|
TH suffix |
大写形式的序数后缀 | DDTH , e.g., 12TH
|
th suffix |
小写形式的序数后缀 | DDth , e.g., 12th
|
FX prefix |
固定的格式化全局选项(见使用须知) | FX Month DD Day
|
TM prefix |
翻译模式(基于lc_time使用本地化的日和月名) | TMMonth
|
SP suffix |
拼写模式(未实现) | 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_to_timestamp(' 2000 JUN', 'YYY-MON')
和to_timestamp('2000 - JUN', 'YYY-MON')
都能工作,但to_timestamp('2000 JUN', 'FXYYYY-MON')
返回一个错误,因为to_timestamp
只期望一个空格。FX
必须指定为模板中的第一个项目。 -
to_timestamp
和to_date
的模板字符串中的分隔符(一个空格或非字母/非数字字符)与输入字符串中的任何一个分隔符相匹配,或者被跳过,除非使用了FX
选项。例如,to_to_timestamp('2000JUN', 'YYY///MON')
和to_timestamp('2000/JUN', 'YYY/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', 'YYY TZH')
与-10
匹配,但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', 'yyyyy-MM-DD')
以前是有效的。 现在,你只能使用字母字符来实现这个目的。 例如,to_timestamp(''2000y6m1d', 'yyyytMMtDDt')
和to_timestamp('2000y6m1d', 'yyyyy"y"MM"m"DD"d"')
跳过y
、m
和d
。 -
如果你想在输出里有双引号,那么你必须在它们前面放反斜线,例如
'\"YYYY Month\"'
。不然,在双引号字符串外面的反斜线就不是特殊的。在双引号字符串内,反斜线会导致下一个字符被取其字面形式,不管它是什么字符(但是这没有特殊效果,除非下一个字符是一个双引号或者另一个反斜线)。 -
在
to_timestamp
和to_date
中,如果年份格式声明少于四位(如YYY
)并且提供的年份少于四位,年份将被调整为最接近于 2020 年,例如95
会变成 1995。 -
在
to_timestamp
和to_date
中,负的年份被视为表示BC。 如果你同时写一个负的年份和一个显式的BC
字段,你又会得到AD。第0年的输入被视为公元前1年。 -
在
to_timestamp
和to_date
中,在处理超过4位数的年份时,YYYY
转换具有限制。你必须在YYYY
后面使用一些非数字字符或者模板, 否则年份总是被解释为 4 位数字。例如(对于 20000 年):to_date('200001131', 'YYYYMMDD')
将会被解释成一个 4 位数字的年份,而不是在年份后使用一个非数字分隔符,像to_date('20000-1131', 'YYYY-MMDD')
或to_date('20000Nov31', 'YYYYMonDD')
。 -
在
to_timestamp
和to_date
中,CC
(世纪)字段会被接受,但是如果有YYY
、YYYY
或者Y,YYY
字段则会忽略它。如果CC
与YY
或Y
一起使用,则结果被计算为指定世纪中的那一年。如果指定了世纪但是没有指定年,则会假定为该世纪的第一年。 -
在
to_timestamp
和to_date
中,工作日名称或编号(DAY
、D
以及相关的字段类型)会被接受,但会为了计算结果的目的而忽略。季度(Q
)字段也是一样。 -
在
to_timestamp
和to_date
中,一个 ISO 8601 周编号的日期(与一个格里高利日期相区别)可以用两种方法之一被指定为to_timestamp
和to_date
:-
年、周编号和工作日:例如
to_date('2006-42-4', 'IYYY-IW-ID')
返回日期2006-10-19
。如果你忽略工作日,它被假定为 1(周一)。 -
年和一年中的日:例如
to_date('2006-291', 'IYYY-IDDD')
也返回2006-10-19
。
尝试使用一个混合了 ISO 8601 周编号和格里高利日期的域来输入一个日期是无意义的,并且将导致一个错误。在一个 ISO 周编号的年的环境下,一个“月”或“月中的日”的概念没有意义。在一个格里高利年的环境下,ISO 周没有意义。用户应当避免混合格里高利和 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 小时的时钟上,即零小时和 36 小时输出为12
,而HH24
会输出完整的小时值,对于间隔它可以超过 23.
表 9.28展示了可以用于格式化数字值的模版模式。
表 9.28. 用于数字格式化的模板模式
模式 | 描述 |
---|---|
9
|
数位(如果无意义可以被删除) |
0
|
数位(即便没有意义也不会被删除) |
. (period) |
小数点 |
, (comma) |
分组(千)分隔符 |
PR
|
尖括号内的负值 |
S
|
带符号的数字(使用区域) |
L
|
货币符号(使用区域) |
D
|
小数点(使用区域) |
G
|
分组分隔符(使用区域) |
MI
|
在指定位置的负号(如果数字 < 0) |
PL
|
在指定位置的正号(如果数字 > 0) |
SG
|
在指定位置的正/负号 |
RN
|
罗马数字(输入在 1 和 3999 之间) |
TH or th
|
序数后缀 |
V
|
移动指定位数(参阅注解) |
EEEE
|
科学记数的指数 |
数字格式化的用法须知:
-
0
指定一个总是被打印的数位,即便它包含前导/拖尾的零。9
也指定一个数位,但是如果它是前导零则会被空格替换,而如果是拖尾零并且指定了填充模式则它会被删除(对于to_number()
来说,这两种模式字符等效)。 -
模式字符
S
、L
、D
以及G
表示当前locale定义的负号、货币符号、小数点以及数字分隔符字符(见lc_monetary和lc_numeric)。不管locale是什么,模式字符句号和逗号就表示小数点和数字分隔符。 -
对于
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
会跳过两个非数据字符。 -
带有
to_char
的V
会把输入值乘上10^
,其中n
n
是跟在V
后面的位数。带有to_number
的V
以类似的方式做除法。to_char
和to_number
不支持使用结合小数点的V
(例如,不允许99.9V99
)。 -
EEEE
(科学记数法)不能和任何其他格式化模式或修饰语(数字和小数点模式除外)组合在一起使用,并且必须位于格式化字符串的最后(例如9.99EEEE
是一个合法的模式)。
某些修饰语可以被应用到任何模板来改变其行为。例如,FM99.99
是带有FM
修饰语的99.99
模式。表 9.29中展示了用于数字格式化模式修饰语。
表 9.29. 用于数字格式化的模板模式修饰语
修饰语 | 描述 | 例子 |
---|---|---|
FM prefix |
填充模式(抑制拖尾零和填充的空白) | FM99.99
|
TH suffix |
大写序数后缀 | 999TH
|
th suffix |
小写序数后缀 | 999th
|
表 9.30展示了一些使用to_char
函数的例子。
表 9.30. 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, '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'
|