9.8. 数据类型格式化功能

PostgreSQL 格式化功能提供了一套功能强大的工具，用于将各种数据类型(日期/时间，整数，浮点数，数字)转换为格式化字符串，以及从格式化字符串转换为特定数据类型。 Table 9.23列出它们。这些函数都遵循一个通用的调用约定：第一个参数是要格式化的值，第二个参数是定义输出或 Importing 格式的模板。

表 9.23. 格式化功能

在to_char输出模板字符串中，根据给定值识别并替换为某些格式的数据的某些模式。非模板模式的任何文本都将被逐字复制。同样，在 Importing 模板字符串(用于其他功能)中，模板模式标识 Importing 数据字符串要提供的值。如果模板字符串中存在不是模板模式的字符，则只需跳过 Importing 数据字符串中的相应字符(无论它们是否等于模板字符串字符)。

Table 9.24显示了可用于格式化日期和时间值的模板模式。

表 9.24. 日期/时间格式的模板模式

可以将修饰符应用于任何模板模式以更改其行为。例如，FMMonth是具有FM修饰符的Month模式。 Table 9.25显示日期/时间格式的修饰符模式。

表 9.25. 用于日期/时间格式的模板模式修改器

日期/时间格式的使用说明：

• FM抑制前导零和尾随空白，否则将其添加以使模式的输出为固定宽度。在 PostgreSQL 中，FM仅修改下一个规范，而在 Oracle 中，FM影响所有后续规范，重复的FM修饰符可打开和关闭填充模式。

• TM不包含尾随空格。 to_timestamp和to_date忽略TM修饰符。

• 除非使用FX选项，否则to_timestamp和to_date会跳过 Importing 字符串中的多个空格。例如，to_timestamp('2000 JUN', 'YYYY MON')有效，但是to_timestamp('2000 JUN', 'FXYYYY MON')返回错误，因为to_timestamp仅期望一个空格。 FX必须指定为模板中的第一项。

• to_char模板中允许使用普通文本，并将按原样输出。您可以将子字符串放在双引号中，以强制将其解释为原义文本，即使该子字符串包含模板模式也是如此。例如，在'"Hello Year "YYYY'中，YYYY将被年份数据替换，但在Year中的单个Y不会被替换。在to_date，to_number和to_timestamp中，Literals 文本和双引号字符串导致跳过字符串中包含的字符数；例如"XX"跳过两个 Importing 字符(无论它们是否为XX)。

• 如果要在输出中使用双引号，则必须在其前面加上反斜杠，例如'\"YYYY Month\"'。反斜杠在双引号字符串之外不是特殊的。在双引号字符串中，反斜杠使下一个字符按字面意义使用，无论它是什么(但是除非下一个字符是双引号或另一个反斜杠，否则这没有特殊作用)。

• 在to_timestamp和to_date中，如果年份格式规范小于四位数，例如YYY，并且所提供的年份少于四位数，则该年份将被调整为最接近 2020 年，例如95变成 1995 年。

• 在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_date('2006-42-4', 'IYYY-IW-ID')返回日期2006-10-19。如果省略工作日，则假定为 1(星期一)。

  • 年中的年月日：例如to_date('2006-291', 'IYYY-IDDD')还返回2006-10-19。

尝试使用 ISO 8601 周编号字段和公历日期字段的混合 Importing 日期是没有意义的，并且会导致错误。在 ISO 8601 周编号年份的上下文中，“月”或“月中的某天”的概念没有意义。在公历年份中，ISO 周没有意义。

• 在to_timestamp中，毫秒(MS)或微秒(US)字段用作小数点后的秒位数。例如to_timestamp('12.3', 'SS.MS')不是 3 毫秒，而是 300，因为转换将其视为 12 0.3 秒。因此，对于格式SS.MS，Importing 值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输出完整的小时值，在interval值中可以超过 23.

Table 9.26显示了可用于格式化数值的模板模式。

表 9.26. 用于数字格式的模板模式

数字格式的使用说明：

• 0指定将始终打印的数字位置，即使它包含前导/后缀零。 9还指定了数字位置，但是如果它是前导零，则将替换为空格，而如果是尾随零并且指定了填充模式，则将其删除。 (对于to_number()，这两个模式字符是等效的.)

• 模式字符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，而是要求在MI之前使用9.)

• TH不转换小于零的值，也不转换小数。

• PL，SG和TH是 PostgreSQL 扩展。

• 在to_number中，如果使用非数据模板模式(例如L或TH)，则无论它们是否与模板模式匹配，都会跳过相应数量的 Importing 字符，除非它们是数据字符(即数字，符号，小数点) ，或逗号)。例如，TH将跳过两个非数据字符。

• V和to_char将 Importing 值乘以10^n，其中* n *是V后的位数。 V和to_number的划分方式相似。 to_char和to_number不支持将V与小数点结合使用(例如，不允许99.9V99)。

• EEEE(科学记号)不能与数字和小数点模式以外的任何其他格式设置模式或修饰符结合使用，并且必须位于格式字符串的末尾(例如9.99EEEE是有效模式)。

可以将某些修饰符应用于任何模板模式以更改其行为。例如，FM99.99是具有FM修饰符的99.99模式。 Table 9.27显示用于数字格式的修饰符模式。

表 9.27. 用于数字格式的模板模式修饰符

Table 9.28显示了使用to_char函数的一些示例。

表 9.28. to_char示例