Redrock Postgres 搜索 英文
版本: 9.3 / 9.4 / 9.5 / 9.6 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17

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

PostgreSQL 格式化函数提供了一套强大的工具来将各种数据类型(日期/时间、整数、浮点数、数值)转换为格式化字符串,以及将格式化字符串转换为特定数据类型。 表 9.26 列出了这些函数。这些函数都遵循一个通用的调用约定:第一个参数是要格式化的值,第二个参数是定义输出或输入格式的模板。

表 9.26. 格式化函数

函数

说明

示例

to_char ( timestamp, text ) → text

to_char ( 带时区的日期时间, 文本 ) → 文本

根据给定的格式将时间戳转换为字符串。

to_char(timestamp '2002-04-20 17:31:12.66', 'HH12:MI:SS')05:31:12

to_char ( 间隔, 文本 ) → 文本

根据给定的格式将间隔转换为字符串。

to_char(interval '15h 2m 12s', 'HH24:MI:SS')15:02:12

to_char ( numeric_type, 文本 ) → 文本

根据给定的格式将数字转换为字符串;可用于 integerbigintnumericrealdouble precision

to_char(125, '999')125

to_char(125.8::real, '999D9')125.8

to_char(-125.8, '999D99S')125.80-

to_date ( 文本, 文本 ) → 日期

根据给定的格式将字符串转换为日期。

to_date('05 Dec 2000', 'DD Mon YYYY')2000-12-05

to_number ( 文本, 文本 ) → numeric

根据给定的格式将字符串转换为 numeric。

to_number('12,454.8-', '99G999D9S')-12454.8

to_timestamp ( 文本, 文本 ) → 带时区的日期时间

根据给定的格式将字符串转换为时间戳。(另请参见 to_timestamp(double precision),位于 表 9.33。)

to_timestamp('05 Dec 2000', 'DD Mon YYYY')2000-12-05 00:00:00-05


提示

to_timestampto_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)
SSSSSSSSS 午夜以来的秒数(0 到 86399)
AMamPMpm 午夜标志(不带句点)
A.M.a.m.P.M.p.m. 午夜标志(带句点)
Y,YYY 年份(4 位或更多位数)带逗号
YYYY 年份(4 位或更多位数)
YYY 年份的最后 3 位数
YY 年份的最后 2 位数
Y 年份的最后一位数
IYYY ISO 8601 周编号年份(4 位或更多位数)
IYY ISO 8601 周编号年份的最后 3 位数
IY ISO 8601 周编号年份的最后 2 位数
I ISO 8601 周编号年份的最后一位数
BCbcADad 世纪标志(不带句点)
B.C.b.c.A.D.a.d. 世纪标志(带句点)
MONTH 全大写的完整月份名称(空格填充到 9 个字符)
Month 全首字母大写的完整月份名称(空格填充到 9 个字符)
month 全小写的完整月份名称(空格填充到 9 个字符)
星期一 月名的缩写形式,大写(英文为 3 个字符,本地化的长度不同)
星期一 月名的缩写形式(英文为 3 个字符,本地化的长度不同)
星期一 月名的缩写形式,小写(英文为 3 个字符,本地化的长度不同)
MM 月份数字(01–12)
星期 星期全称为大写(用空格填充到 9 个字符)
星期日 星期全称为首字母大写(用空格填充到 9 个字符)
星期一 星期全称为小写(用空格填充到 9 个字符)
星期二 星期名的缩写形式,大写(英文为 3 个字符,本地化的长度不同)
星期三 星期名的缩写形式,首字母大写(英文为 3 个字符,本地化的长度不同)
星期四 星期名的缩写形式,小写(英文为 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)(第一周从该月的第 1 天开始)
WW 一年中的周数(1–53)(第一周从该年的第 1 天开始)
IW ISO 8601 周数年的周数(01–53;该年的第一个星期四在第 1 周)
CC 世纪(2 位数字)(21 世纪从 2001-01-01 开始)
J 儒略历日期(公元前 4714 年 11 月 24 日当地午夜以来的整数天数;参见B.7 节儒略历日期
Q 季度
RM 月的大写罗马数字(I–XII;I=1 月)
rm 月的小写罗马数字(i–xii;i=1 月)
TZ 时区缩写,大写
tz 时区缩写,小写
TZH 时区的时数
TZM 时区的分钟数
OF 从 UTC 开始计算的时区偏移(HHHH:MM

修改器可以应用于任何模板模式以更改其行为。例如,FMMonthMonth 模式与FM 修改器。 表 9.28 显示了用于日期/时间格式化的修改器模式。

表 9.28。日期/时间格式化的模板模式修改器

修改器 说明 示例
FM 前缀 填充模式(抑制前导零并填充空格) FMMonth
TH 后缀 大写序数后缀 DDTH,例如 12TH
th 后缀 小写序数后缀 DDth,例如 12th
FX 前缀 固定格式全局选项(请参阅使用说明) FX Month DD Day
TM 前缀 转换模式(基于 lc_time 使用本地化的日期和月份名称) TMMonth
SP 后缀 拼写模式(未实现) DDSP

有关日期/时间格式化的使用说明

表格 9.29 展示了用来进行数值格式化的可用模板模式。

表格 9.29 数值格式化模板模式

模式 说明
9 数字位置(如果显得无意义,则可以忽略)
0 数字位置(即使显得无意义,也不能忽略)
.(句号) 小数点
,(逗号) 组(千位)分隔符
PR 尖括号中的负值
S 固定在数字上的符号(使用语言环境)
L 货币符号(使用语言环境)
D 小数点(使用语言环境)
G 组分隔符(使用语言环境)
MI 减号位于指定位置(如果数字 < 0)
PL 加号位于指定位置(如果数字 > 0)
SG 加减号位于指定位置
RN 罗马数字(1 到 3999 之间的输入)
THth 序数后缀
V 移动指定数量的数字(参阅注释)
EEEE 科学计数法的指数

数值格式化的使用说明

可以将某些修饰符应用到任何模板模式以更改其行为。例如,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') '星期二, 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'