9.8. 数据类型格式化函数

PostgreSQL格式化函数提供一套有效的工具用于把各种数据类型(date/time， integer， floating point， numeric) 转换成格式化的字符串以及反过来从格式化的字符串转换成指定的数据类型。表Table 9-20列出了这些函数。 这些函数都遵循一个公共的调用约定： 第一个参数是待格式化的值，而第二个是定义输出或输入格式的模板。

to_timestamp函数一个参数也是可用的。它接受一个double precision参数， 转换从Unix 纪元（自1970-01-01 00:00:00+00起的秒数）为timestamp with time zone。 （Integer类型的 Unix 纪元隐含地转换成了double precision。）

在to_char的输出模板字符串里，有一定的替换模式，在给定值的基础上，正确地替换为相应格式的数据。 并不是一个模板模式的任何文本只是逐字复制。同样，在一个输入模板字符串里（的其它函数）， 模板模式标识着要提供输入数据字符串的格式值。

Table 9-21显示了可以用于格式化日期和时间值的模版。

有一些修饰词可以应用于模板来修改它们的行为。例如，FMMonth就是带着FM前缀 的Month模式。表Table 9-22显示了用于日期/时间格式化的修饰词模式。

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

• FM抑制前导的零或尾跟的空白，如果没有使用它的话， 会在输出中增加这些填充最终把输出变成固定宽度的模式。 在PostgreSQL中，FM仅修改下一步的规范， 当OracleFM会影响后续的所有规范，而且反复FM 修饰词切换填充模式的开关。

• TM不包含结尾空白.

• to_timestamp和to_date会跳过多个空白， 除非在输入字符串中使用FX选项.举例如下， 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，双引号的字符串会跳过输入的字符串相应数目的字符，例如"XX" 跳过两个输入字符。

• 如果你想在输出里有双引号，那么你必须在它们前面放双反斜杠， 例如E'\\"YYYY Month\\"' (需要两个反斜杠是因为反斜杠在使用逃逸字符串语法里，有特殊含义)。

• 如果你使用的年份长于4位字符，那么用YYYY从字符串向 timestamp或date做转换时要受到限制。你必须在YYYY后面使用 一些非数字字符或者模板，否则年份总是解释为 4 位数字。比如 对于 20000 年：to_date('200001131'， 'YYYYMMDD')将会 被解释成一个 4 位数字的年份，最好在年后面使用一个非数字的分隔符，像 to_date('20000-1131'， 'YYYY-MMDD')或 to_date('20000Nov31'， 'YYYYMonDD'). 。

• 在从字符串向timestamp或date转换的时候，如果有YYY，YYYY或 Y，YYY字段，那么CC字段会被忽略。如果CC与YY或Y一起使用， 那么年份用公式(CC-1)*100+YY计算。

• An ISO week date (as distinct from a Gregorian date) can be specified toto_timestampand to_datein one of two ways: 可以通过to_timestamp和to_date两种方法之一，指定一个ISO周日期（与公历日期不同）：

  • 格式：年， 周， 和 周天: 例如to_date('2006-42-4'， 'IYYY-IW-ID')返回日期为2006-10-19。 如果忽略了周天，将默认为1（星期一）。

  • 格式：年 和年中的天数: 例如to_date('2006-291'， 'IYYY-IDDD')也是返回2006-10-19。

  尝试构造一个混合使用ISO周日期和公历日期字段是没有意义的，将导致错误。 在一个ISO年的情况下，"月"或"月中天数"的概念已经没有意义。 在公历年的情况下，ISO 周 没有意义。用户应避免混合公历和ISO日期表示。

• 将字符串转化为timestamp时，毫秒(MS)和微秒(US)都是用字符串的 小数点后面的部分转换的。如to_timestamp('12:3'， 'SS:MS') 不是 3 毫秒， 而是 300 毫秒，因为转换把它看做 12+0.3 秒。这意味 着对于格式SS:MS而言，输入值12:3，12:30，12:300声明了相同的毫秒数。 对于 3 毫秒，你必须使用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秒。

• to_char(...， 'ID')的周天数匹配函数extract(isodow from ...)，但是to_char(...， 'D') 不匹配extract(dow from ...)的天数。

• to_char(interval)格式HH和 HH12作为12小时时钟显示， 即 zero 小时 和 36 hours 输出为12， 当HH24 输出整小时值， 可以为超过23的间隔。

在Table 9-23中显示可用于数值格式化的模板模式。

Usage notes for numeric formatting: 数字格式化的用法须知：

• 使用SG，PL，MI生成的符号并不挂在数字上面；比 如，to_char(-12， 'MI9999')produces'-  12'生成to_char(-12， 'S9999')生 成'  -12'。Oracle里 的实现不允许在9前面使用MI，而是要求9在MI前面。

• 9声明和9的个数相同的数字位数的数值。如果某个数值位没有数字，则输出一个空白。

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

• PL，SG， TH是PostgreSQL扩展

• V方便地把输入值乘以 10^n ，这里n是跟在V后面的数字。 to_char不支持把V与一个小数点组合在一起使用(也就是说 99.9V99 是不允许的)。

• EEEE（科学记数）不能被用来在与任何其它格式模式组合或数字和小数点模式之外的修饰符， 必须在格式字符串的末尾（例如，9.99EEEE的是一个有效的模式）。

某些修饰符可以应用于模板来改变其行为。 例如，FM9999是带有FM修饰符的模式。 在Table 9-24中数字格式的模式修饰符.

Table 9-25显示了一些to_char函数的用法。