9.8. 数据类型格式化函数

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

to_timestamp 函数也能接受一个 double precision 参数，把它从 Unix 纪元转换成 timestamp with time zone。Integer 类型的 Unix 纪元隐含地转换成了 double precision 。

在输出模板字符串里(对 to_char 而言)，该函数族可以识别一些特定的模式，并且把待格式化的数值正确地格式化成相应的数据。任何不属于模板模式的文本都简单地逐字拷贝。同样，在一个输入模板字符串里(对除 to_char 外的任何东西)，模板模式标识要查看的输入数据字符串，并且将在该位置寻找数值。

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

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

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

• FM 抑制前导的零或尾随的空白，如果没有使用它的话，会在输出中增加这些填充最终把输出变成固定宽度的模式。

• TM 不包含结尾空白。

• 如果没有使用 FX ，to_timestamp 和 to_date 在转换字符串的时候忽略多个空白。FX 必须做为模板里的第一个项声明。比如 to_timestamp('2000    JUN', 'YYYY MON') 是正确的，但是 to_timestamp('2000    JUN', 'FXYYYY MON') 会返回一个错误，因为 to_timestamp 只预料会有一个空白。

• 在 to_char 模板里可以有普通文本，并且它们会被逐字输出。你可以把一个字符串放到双引号里强迫它解释成一个文本，即使它里面包含模式关键字也如此。比如，'"Hello Year "YYYY' 中的 YYYY 将被年份数据代替，但是 Year 里单独的 Y 不会。

• 如果你想在输出里有双引号，那么你必须在它们前面放双反斜杠，比如 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 计算。

• 将字符串转化为 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 的星期编号(参阅'D'格式化模式)与 extract 的不同。

• to_char(interval) 将 HH 和 HH12 格式化为一日之内的小时数，而 HH24 可以输出超出一日的小时数，比如 >24 。

表9-23 shows the template patterns available for formatting numeric values

数字格式化的用法须知：

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

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

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

• PL, SG, TH 是 PostgreSQL 扩展。

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

表9-24 显示了一些 to_char 函数的用法。