4.7. 数据类型格式化函数

PostgreSQL 格式化函数提供一套有效的工具用于把各种数据类型 （日期/时间，integer，floating point，numeric） 转换成格式化的字符串以及反过来从格式化的字符串转换成 指定的数据类型。 这些函数都遵循一个公共的调用习惯： 第一个参数是待格式化的值，而第二个是一个定义输出格式的模板．

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

有一些修饰词可以应用于模板来修改它们的行为．比如， " FMMonth " 就是 带着 " FM " 前缀的 " Month " 模式．

用法须知：

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

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

• 如果在字串常量里需要反斜杠（ " \ " ）， 那么你必须输入双反斜杠 （ " \\ " ） 比如 '\\HH\\MI\\SS' 。对于 PostgreSQL 里的任何字串常量都是这样的．

• 在 to_char 模板 里可以有普通文本，但是任何在双引号之间的字串 都不会被解释为模板关键字并且它们处理得也更快些． （例子: '"Hello Year: "YYYY' ）。

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

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

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

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

用法须知：

• 使用 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 是不允许的）。