©
このドキュメントでは、 php中国語ネットマニュアル リリース
PostgreSQL格式化函数提供一套有效的工具用于把各种数据类型(date/time, integer, floating point, numeric) 转换成格式化的字符串以及反过来从格式化的字符串转换成指定的数据类型。表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(timestamp,text) |
text | 将时间戳转换成字符串 | to_char(current_timestamp, 'HH12:MI:SS') |
to_char(interval,text) |
text | 把时间间隔转为字符串 | to_char(interval '15h 2m 12s', 'HH24:MI:SS') |
to_char(int,text) |
text | 将整数转换成字符串 | to_char(125, '999') |
to_char (double precision,
text) |
text | 将实数/双精度数转换成字符串 | to_char(125.8::real, '999D9') |
to_char(numeric,text) |
text | 将数字转换成字符串 | to_char(-125.8, '999D99S') |
to_date(text,text) |
date | 将字符串转换成日期 | to_date('05 Dec 2000', 'DD Mon YYYY') |
to_number(text,text) |
numeric | 将字符串转换成数字 | to_number('12,454.8-', '99G999D9S') |
to_timestamp(text,text) |
timestamp with time zone | 将字符串转换成带时区的时间戳 | to_timestamp('05 Dec 2000', 'DD Mon YYYY') |
to_timestamp(double precision) |
timestamp with time zone | 将 UNIX 纪元转换成时间戳 | to_timestamp(1284352323) |
在to_char
的输出模板字符串里,有一定的替换模式,在给定值的基础上,正确地替换为相应格式的数据。
并不是一个模板模式的任何文本只是逐字复制。同样,在一个输入模板字符串里(的其它函数),
模板模式标识着要提供输入数据字符串的格式值。
Table 9-21显示了可以用于格式化日期和时间值的模版。
Table 9-21. 用于日期/时间格式化的模式
模式 | 描述 |
---|---|
HH | 一天的小时(01-12) |
HH12 | 一天的小时(01-12) |
HH24 | 一天的小时(00-23) |
MI | 分钟(00-59) |
SS | 秒(00-59) |
MS | 毫秒(000-999) |
US | 微秒(000000-999999) |
SSSS | 午夜后的秒(0-86399) |
AM,am, PMorpm下午标识(大写) | 正午标识(没有间隔符) |
A.M.,a.m., P.M.orp.m.上下午标识(小写) | 正午标识 (有间隔符) |
Y,YYY | 带逗号的年(4 和更多位) |
YYYY | 年(4 和更多位) |
YYY | 年的后三位 |
YY | 年的后两位 |
Y | 年的最后一位 |
IYYY | ISO年(4 位或更多位) |
IYY | ISO年的后三位 |
IY | ISO年的后两位 |
I | ISO年的后一位 |
BC,bc, ADorad | 纪元标识(没有间隔符) |
B.C.,b.c., A.D.ora.d. | 纪元标(有间隔符) |
MONTH | 大写的月份全名(空白填充为9个字符) |
Month | 首字母大写的月份全名(空白填充为9个字符) |
month | 小写的月份全名(空白填充为9个字符) |
MON | 大写的月份缩写名(英文为3个字符,本地化长度不定) |
Mon | 首字母大写的月份缩写名(英文为3个字符,本地化长度不定) |
mon | 小写的月份缩写名(英文为3个字符,本地化长度不定) |
MM | 月数(01-12) |
DAY | 大写的天全名(空白填充为9个字符) |
Day | 首字母大写的天全名(空白填充为9个字符) |
day | 小写的天全名(空白填充为9个字符) |
DY | 大写天的缩写名(英文为3个字符,本地化长度不定) |
Dy | 首字母大写的天缩写名(英文为3个字符,本地化长度不定) |
dy | 小写天的缩写名(英文为3个字符,本地化长度不定) |
DDD | 年中天数(001-366) |
IDDD | ISO 年中天数 (001-371; 年中的第1天为ISO第一周的星期一) |
DD | 月里的天数(01-31) |
D | 周中天数, 一周里的日(1-7 ;星期天是 1,星期六是 7) |
ID | ISO 周中天数,(1-7:星期一是 1,星期天是 7) |
W | 月中周数 (1-5)(第一周从该月第一天开始) |
WW | 年中周数 (1-53)(第一周从该年的第一天开始) |
IW | ISO 年中周数 (01 - 53; 第一个星期四所在周为第1周) |
CC | 世纪(2 位)(20 世纪从 2001-01-01 开始) |
J | 儒略日(自公元前 4712 年 1 月 1 日来的天数) |
Q | 季度(to_date 和to_timestamp 忽略) |
RM | 罗马数字的月份(I-XII ;I=JAN)(大写) |
rm | 罗马数字的月份(I-XII ;I=JAN)(小写) |
TZ | 时区名(大写) |
tz | 时区名(小写) |
有一些修饰词可以应用于模板来修改它们的行为。例如,FMMonth就是带着FM前缀 的Month模式。表Table 9-22显示了用于日期/时间格式化的修饰词模式。
Table 9-22. 日期/时间格式化的模板模式修饰词
修饰符 | 描述 | 示例 |
---|---|---|
FM前缀 | 填充模式(支持填充空白和零) | FMMonth |
TH后缀 | 大写序号后缀 | DDTH, 例如,12TH |
th后缀 | 小写序号后缀 | DDth, 例如,12th |
FX前缀 | 固定格式的全局选项(见用法须知? | FX Month DD Day |
TM前缀 | 翻译模式(基于lc_time显示本地化的日期和月份名) | TMMonth |
SP后缀 | 拼写模式(还未实现) | DDSP |
日期/时间格式化的用法说明:
FM抑制前导的零或尾跟的空白,如果没有使用它的话, 会在输出中增加这些填充最终把输出变成固定宽度的模式。 在PostgreSQL中,FM仅修改下一步的规范, 当OracleFM会影响后续的所有规范,而且反复FM 修饰词切换填充模式的开关。
TM不包含结尾空白.
to_timestamp
和to_date
会跳过多个空白,
除非在输入字符串中使用FX选项.举例如下,
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"
跳过两个输入字符。
如果你想在输出里有双引号,那么你必须在它们前面放双反斜杠, 例如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计算。
An ISO week date (as distinct from a Gregorian date) can be
specified toto_timestamp
and
to_date
in one of two ways:
可以通过to_timestamp
和to_date
两种方法之一,指定一个ISO周日期(与公历日期不同):
格式:年, 周, 和 周天: 例如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小时时钟显示, 即 zero 小时
和 36 hours 输出为12, 当HH24
输出整小时值, 可以为超过23的间隔。
在Table 9-23中显示可用于数值格式化的模板模式。
Table 9-23. 数值格式化的模版模式。
模式 | 描述 |
---|---|
9 | 带有指定数值位数的值 |
0 | 带前导零的值 |
.(period) | 小数点 |
,(comma) | 分组(千)分隔符 |
PR | 尖括号内负值 |
S | 带符号的数值(使用区域设置) |
L | 货币符号(使用区域设置) |
D | 小数点(使用区域设置) |
G | 分组分隔符(使用区域设置) |
MI | 在指明位置的负号(如果数字< 0) |
PL | 在指明位置的正号(如果数字 >0) |
SG | 在指明位置的正/负号 |
RN | 罗马数字(输入在 1 和 3999 之间) |
THorth | 序数后缀 |
V | 移动指定位数(参阅注解) |
EEEE | 指数为科学记数法科学记数(尚未实现) |
Usage notes for numeric formatting: 数字格式化的用法须知:
使用SG,PL,MI生成的符号并不挂在数字上面;比 如,to_char(-12, 'MI9999')produces'- 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是带有FM修饰符的模式。 在Table 9-24中数字格式的模式修饰符.
Table 9-24. 用于数值格式化的模板模式修饰词
修饰符 | 描述 | 示例 |
---|---|---|
FMprefix | 填充模式 (禁止填充空白和零) | FM9999 |
THsuffix | 大写序号后缀 | 999TH |
thsuffix | 小写序号后缀 | 999th |
Table 9-25显示了一些to_char
函数的用法。
Table 9-25. to_char
示例
表达式 | 结果 |
---|---|
to_char(current_timestamp, 'Day, DD HH12:MI:SS') | 'Tuesday , 06 05:39:18' |
to_char(current_timestamp, 'FMDay, FMDD HH12:MI:SS') | 'Tuesday, 6 05:39:18' |
to_char(-0.1, '99.99') | ' -.10' |
to_char(-0.1, 'FM9.99') | '-.1' |
to_char(0.1, '0.9') | ' 0.1' |
to_char(12, '9990999.9') | ' 0012.0' |
to_char(12, 'FM9990999.9') | '0012.' |
to_char(485, '999') | ' 485' |
to_char(-485, '999') | '-485' |
to_char(485, '9 9 9') | ' 4 8 5' |
to_char(1485, '9,999') | ' 1,485' |
to_char(1485, '9G999') | ' 1 485' |
to_char(148.5, '999.999') | ' 148.500' |
to_char(148.5, 'FM999.999') | '148.5' |
to_char(148.5, 'FM999.990') | '148.500' |
to_char(148.5, '999D999') | ' 148,500' |
to_char(3148.5, '9G999D999') | ' 3 148,500' |
to_char(-485, '999S') | '485-' |
to_char(-485, '999MI') | '485-' |
to_char(485, '999MI') | '485 ' |
to_char(485, 'FM999MI') | '485' |
to_char(485, 'PL999') | '+485' |
to_char(485, 'SG999') | '+485' |
to_char(-485, 'SG999') | '-485' |
to_char(-485, '9SG99') | '4-85' |
to_char(-485, '999PR') | '<485>' |
to_char(485, 'L999') | 'DM 485 |
to_char(485, 'RN') | ' CDLXXXV' |
to_char(485, 'FMRN') | 'CDLXXXV' |
to_char(5.2, 'FMRN') | 'V' |
to_char(482, '999th') | ' 482nd' |
to_char(485, '"Good number:"999') | 'Good number: 485' |
to_char(485.8, '"Pre:"999" Post:" .999') | 'Pre: 485 Post: .800' |
to_char(12, '99V999') | ' 12000' |
to_char(12.4, '99V999') | ' 12400' |
to_char(12.45, '99V9') | ' 125' |
to_char(0.0004859, '9.99EEEE') | ' 4.86e-04' |