Postgres 中 to_char 格式化記錄

Postgres 格式化函數提供一套有效的工具用於把各類數據類型（日期/時間，int，float，numeric）轉換成格式化的字符串以及反過來從格式化的字符串轉換成原始的數據類型。

注意：全部格式化函數的第二個參數是用於轉換的模板。

表  格式化函數 
 

函數	返回	描述	例子
to_char(timestamp, text)	text	把 timestamp 轉換成 string	to_char(timestamp 'now','HH12:MI:SS')
to_char(int, text)	text	把 int4/int8 轉換成 string	to_char(125, '999')
to_char(float, text)	text	把 float4/float8 轉換成 string	to_char(125.8, '999D9')
to_char(numeric, text)	text	把 numeric 轉換成 string	to_char(numeric '-125.8', '999D99S')
to_date(text, text)	date	把 string 轉換成 date	to_date('05 Dec 2000', 'DD Mon YYYY')
to_timestamp(text, text)	date	把 string 轉換成 timestamp	to_timestamp('05 Dec 2000', 'DD Mon YYYY')
to_number(text, text)	numeric	把 string 轉換成 numeric	to_number('12,454.8-', '99G999D9S')

表  用於 date/time 轉換的模板 
 

模板	描述
HH	一天的小時數 (01-12)
HH12	一天的小時數 (01-12)
HH24	一天的小時數 (00-23)
MI	分鐘 (00-59)
SS	秒 (00-59)
SSSS	午夜後的秒 (0-86399)
AM or A.M. or PM or P.M.	正午標識（大寫）
am or a.m. or pm or p.m.	正午標識（小寫）
Y,YYY	帶逗號的年（4 和更多位）
YYYY	年（4和更多位）
YYY	年的後三位
YY	年的後兩位
Y	年的最後一位
BC or B.C. or AD or A.D.	年標識（大寫）
bc or b.c. or ad or a.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)
DD	一個月裏的日子(01-31)
D	一週裏的日子(1-7；SUN=1)
W	一個月裏的週數
WW	一年裏的週數
CC	世紀（2 位）
J	Julian 日期（自公元前4712年1月1日來的日期）
Q	季度
RM	羅馬數字的月份（I-XII；I=JAN）－大寫
rm	羅馬數字的月份（I-XII；I=JAN）－小寫

全部模板都都容許使用前綴和後綴修改器。模板里老是容許使用修改器。前綴　'FX' 只是一個全局修改器。

表  用於日期/時間模板 to_char() 的後綴 
 

後綴	描述	例子
FM	填充模式前綴	FMMonth
TH	大寫順序數後綴	DDTH
th	小寫順序數後綴	DDTH
FX	固定模式全局選項（見下面）	FX Month DD Day
SP	拼寫模式（還未實現）	DDSP

用法須知：

• 若是沒有使用 FX 選項，to_timestamp 和 to_date 忽略空白。FX 必須作爲模板裏的第一個條目聲明。

• 反斜槓（"/"）必須用作雙反斜槓（"//"），例如 '//HH//MI//SS'。

• 雙引號（'"'）之間的字串被忽略而且不被分析。若是你想向輸出寫雙引號，你必須在雙引號前面放置一個雙反斜槓（'//'），例如 '//"YYYY Month//"'。

• to_char 支持不帶前導雙引號（'"'）的文本，可是在雙引號之間的任何字串會被迅速處理而且還保證不會被看成模板關鍵字解釋（例如：'"Hello Year: "YYYY'）。

表  用於 to_char(numeric) 的模板 
 

模板	描述
9	帶有指定位數的值
0	前導零的值
. （句點）	小數點
, （逗號）	分組（千）分隔符
PR	尖括號內負值
S	帶負號的負值（使用本地化）
L	貨幣符號（使用本地化）
D	小數點（使用本地化）
G	分組分隔符（使用本地化）
MI	在指明的位置的負號（若是數字 < 0）
PL	在指明的位置的正號（若是數字 > 0）
SG	在指明的位置的正/負號
RN	羅馬數字（輸入在 1 和 3999 之間）
TH or th	轉換成序數
V	移動 n 位（小數）（參閱註解）
EEEE	科學記數。如今不支持。

用法須知：

• 使用 'SG'，'PL' 或 'MI' 的帶符號字並不附着在數字上面；例如，to_char(-12, 'S9999') 生成 ' -12'，而 to_char(-12, 'MI9999') 生成 '- 12'。Oracle 裏的實現不容許在 9 前面使用 MI，而是要求 9 在 MI 前面。

• PL，SG，和 TH 是 Postgres 擴展。

• 9 代表一個與在 9 字串裏面的同樣的數字位數。若是沒有可用的數字，那麼使用一個空白（空格）。

• TH 不轉換小於零的值，也不轉換小數。TH 是一個 Postgres 擴展。

• V 方便地把輸入值乘以 10^n，這裏 n 是跟在 V 後面的數字。to_char 不支持把 V 與一個小數點綁在一塊兒使用（例如. "99.9V99" 是不容許的）。

表  to_char 例子 
 

輸入	輸出
to_char(now(),'Day, HH12:MI:SS')	'Tuesday , 05:39:18'
to_char(now(),'FMDay, HH12:MI:SS')	'Tuesday, 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,'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,'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-decimal:"999" Post-decimal:" .999')	'Pre-decimal: 485 Post-decimal: .800'
to_char(12,'99V999')	' 12000'
to_char(12.4,'99V999')	' 12400'
to_char(12.45, '99V9')	' 125'