9.8. 数据类型格式化函数

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

单参数to_timestamp函数也可以使用；它接受一个double precision 参数，并且从Unix纪元（秒自1970-01-01 00:00:00+00）转换为timestamp with time zone 类型。（Integer类型的Unix纪元隐含的转换为double precision类型。）

Table 9-20. 格式化函数

在to_char输出模板字符串里，该函数族可以识别一些特定的模式， 并且把给定的数值正确地格式化成相应的数据。任何不属于模板模式的文本都简单地逐字拷贝。 同样，在一个输入模板字符串里(对其他函数)，模板模式标识数值由输入数据字符串提供。

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

Table 9-21. 用于日期/时间格式化的模式

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

Table 9-22. 日期/时间格式化的模板模式修饰词

日期/时间格式化的用法须知：

• FM suppresses leading zeroes and trailing blanks that would otherwise be added to make the output of a pattern be fixed-width. In PostgreSQL, FM modifies only the next specification, while in Oracle FM affects all subsequent specifications, and repeated FM modifiers toggle fill mode on and off.

  FM抑制前导的零或尾随的空白，如果没有使用它的话， 会在输出中增加这些填充最终把输出变成固定宽度的模式。 在PostgreSQL中，FM只修改下一个规范， 而在Oracle中FM影响所有随后的规范， 并且重复FM修饰符填充模式开关打开或关闭。

• TM不包含结尾空白。

• 如果没有使用FX，to_timestamp和to_date 在转换字符串的时候忽略多个空白。比如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"忽略两个输入字符。

• 如果你想在输出里有双引号，那么你必须在它们前面放反斜杠，比如'\"YYYY Month\"'。

• 如果年份的格式规范少于四个字节，例如YYY，并且提供的年份少于四个字节， 那么年份将调整为接近于2020，例如95成为1995。

• 如果你使用的年份长于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一起使用， 那么年份用指定的世纪计算。如果指定了世纪而没有指定年，那么假设使用这个世纪的第一年。

• ISO周时间（有别于公历日期）可以用下面的两种方法之一声明为 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周和公历日期字段混合构造日期是没有意义的，并且将导致一个错误。 在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小时， 也就是零时和36时输出是12，而HH24可以输出完整的小时数， 时间间隔可以超过23。

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

Table 9-23. 数值格式化的模版模式

数字格式化的用法须知：

• 使用SG, PL, MI 生成的符号并不挂在数字上面；比如，to_char(-12, 'MI9999') 生成'- 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 是9999模式和FM修饰符。 Table 9-24显示了数字格式的修饰符模式。

Table 9-24. 数字格式的模板模式修饰符

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

Table 9-25. to_char 示例