9.8. 数据类型格式化函数

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

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

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

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

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

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

• 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_timestamp和to_date 用来处理不能通过简单转换被转换的输入格式。 这些函数用最小的错误检查解释输入。当它们产生有效的输出时， 转换可以产生预想不到的结果。例如，这些函数的输入不受正常范围的约束， 因此to_date('20096040','YYYYMMDD')返回 2014-01-17而不是引起一个错误。 类型转换没有这样的行为。

• 在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 8601周编号日期（有别于公历日期）可以用下面的两种方法之一声明为 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 8601周编号字段和公历日期字段混合输入日期是没有意义的， 并且将导致一个错误。在ISO 8601周编号年的范围，"月" 和"月中的天"的概念没有意义。在公历年的范围，ISO周没有意义。

  小心

  虽然to_date拒绝公历和ISO周编号日期字段的混合， 但是to_char并不拒绝，因为像YYYY-MM-DD (IYYY-IDDD) 这样的输出格式说明是有用的。但是要避免像IYYY-MM-DD这样写； 它将会在年的开始附近产生意外的结果。（参阅第 9.9.1 节 获取更多信息。）

• 将字符串转化为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。

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

数字格式化的用法须知：

• 使用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修饰符。 表 9-25显示了数字格式的修饰符模式。

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