PostgreSQL 10.1 手册_部分 II. SQL 语言_第 9 章 函数和操作符_9.8. 数据类型格式化函数

FM抑制前导的零或尾随的空白， 否则会把它们增加到输入从而把一个模式的输出变成固定宽度。在PostgreSQL中，FM只修改下一个声明，而在 Oracle 中，FM影响所有随后的声明，并且重复的FM修饰语将触发填充模式开和关。

TM不包括结尾空白。 to_timestamp和to_date忽略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\"'。

在to_timestamp和to_date中，如果年份格式声明少于四位（如YYY）并且提供的年份少于四位，年份将被调整为最接近于 2020 年，例如95会变成 1995。

在to_timestamp和to_date中，在处理长于 4 位的年份时，YYYY的转换有一个限制。你必须在YYYY后面使用一些非数字字符或者模板， 否则年份总是被解释为 4 位数字。例如（对于 20000 年）：to_date('200001131', 'YYYYMMDD')将会被解释成一个 4 位数字的年份，而不是在年份后使用一个非数字分隔符，像to_date('20000-1131', 'YYYY-MMDD')或to_date('20000Nov31', 'YYYYMonDD')。

在to_timestamp和to_date中，如果有YYY、YYYY或者Y,YYY域， 那么接受CC（世纪）域但是忽略它。如果CC和YY或Y一起使用， 那么结果被计算时会认为年份位于指定的世纪中。如果该世纪被指定但是年份没有被指定，将假定用该世纪的第一年。

在to_timestamp和to_date中， 接受星期几或数字（DAY、D和相关的字段类型）， 但为了计算结果而忽略。季度（Q）字段也是如此。

在to_timestamp和to_date中，一个 ISO 8601 周编号的日期（与一个格里高利日期相区别）可以用两种方法指定：

尝试使用一个混合了 ISO 8601 周编号和格里高利日期的域来输入一个日期是无意义的，并且将导致一个错误。在一个 ISO 周编号的年的环境下，一个“月”或“月中的日”的概念没有意义。在一个格里高利年的环境下，ISO 周没有意义。用户应当避免混合格里高利和 ISO 日期声明。

在to_timestamp中，毫秒（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', 'HH24: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会输出完整的小时值，在interval值中它可以超过 23。

0指定总是被输出的数字位，即使它包含一个前导/尾随零。 9也指定一个数字位，但是如果是一个前导零， 那么它将被空格替代，而如果是一个尾随零并且指定了填充模式， 那么它将被删除。（对于to_number()，这两种模式字符是相等的。）

模式字符S、L、D和G 表示当前环境定义的符号、货币符号、小数点和千位分隔符字符 （参见lc_monetary和lc_numeric）。 模式字符的句号和逗号代表那些精确的字符，带有小数点和千位分隔符的含义， 不管语言环境如何。

如果没有明确规定to_char()的模式中的符号， 则将为该符号保留一列，并将其锚定到该数字（出现在其左侧）。 如果S出现在一些9的左边，它将同样被锚定到数字上。

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

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

PL、SG和TH是PostgreSQL扩展。

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

EEEE（科学记数法）不能和任何其他格式化模式或修饰语（数字和小数点模式除外）组合在一起使用，并且必须位于格式化字符串的最后（例如9.99EEEE是一个合法的模式）。