PostgreSQL 格式化函數提供一套有效的工具用於把各種數據類型 (日期/時間,integer,floating point,numeric) 轉換成格式化的字符串以及反過來從格式化的字符串轉換成 指定的數據類型。 Table 9-20 列出了這些函數。 這些函數都遵循一個公共的調用習慣: 第一個參數是待格式化的值,而第二個是一個定義輸出或輸出格式的模板。
to_timestamp 函數也能接受一個 double precision 參數, 把它從 Unix 紀元轉換成 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 | 把 numeric 轉換成字串 | to_char(-125.8, '999D99S') |
to_date(text, text) | date | 把字串轉換成日期 | to_date('05 Dec 2000', 'DD Mon YYYY') |
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(200120400) |
to_number(text, text) | numeric | 把字串轉換成 numeric | to_number('12,454.8-', '99G999D9S') |
在輸出模板字串裏(對 to_char 而言),該函數族可以識別一些特定的模式,並且 把待格式化的數值正確地格式化成相應的數據。 任何不屬於模板模式的文本都簡單地照字拷貝。同樣,在一個輸入 模板字串裏(對除 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 或 A.M. 或 PM 或 P.M. | 正午標識(大寫) |
am 或 a.m. 或 pm 或 p.m. | 正午標識(小寫) |
Y,YYY | 帶逗號的年(4 和更多位) |
YYYY | 年(4和更多位) |
YYY | 年的後三位 |
YY | 年的後兩位 |
Y | 年的最後一位 |
IYYY | ISO 年(4位或更多位) |
IYY | ISO 年的最後 3 位 |
IY | ISO 年的最後 2 位 |
I | ISO 年的最後一位 |
BC 或 B.C. 或 AD 或 A.D. | 紀元標識(大寫) |
bc 或 b.c. 或 ad 或 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;週日是1) |
W | 一個月裏的週數(1-5)(第一週從該月第一天開始) |
WW | 一年裏的週數(1-53)(第一週從該年的第一天開始) |
IW | ISO 一年裏的週數(第一個星期四在第一週裏) |
CC | 世紀(2 位) |
J | 儒略日(自公元前4712年1月1日來的天數) |
Q | 季度 |
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 |
th 後綴 | 小寫順序數後綴 | DDth |
FX 前綴 | 固定格式全局選項(見用法須知) | >FX Month DD Day |
SP suffix | 拼寫模式(還未實現) | DDSP |
日期/時間格式化的用法須知:
-
FM 抑制前導的零或尾隨的空白, 如果沒有使用它的話,會在輸出中增加這些填充最終把輸出變成固定寬度的模式。
-
如果沒有使用 FX 選項, to_timestamp 和 to_date 在轉換字串的時候忽略多個空白。 FX 必須做爲模板裏的第一個項聲明。 比如 to_timestamp('2000 JUN', 'YYYY MON') 是正確的, to_timestamp('2000 JUN', 'FXYYYY MON') 會返回一個錯誤,因爲to_timestamp 只預料會有一個空白。
-
在 to_char 模板 裏可以有普通文本,並且它們會被照字輸出。 你可以把一個字串放到雙引號裏強迫它解釋成一個文本, 即使它裏面包含模式關鍵字也如此。比如,在 '"Hello Year "YYYY', YYYY 將被年份數據代替,但是Year裏單獨 的 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')。
-
在從字串向 timestamp 或 date 轉換的時候, 如果有 YYY,YYYY 或者 Y,YYY 字段, 那麼 CC 字段會被忽略。 如果 CC 和 YY 或 Y 一起使用, 那麼年份時用公式 (CC-1)*100+YY 計算的。
-
將字串轉化爲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', 'HH:MI:SS.MS.US') 是 15 小時,12 分鐘,和 2 秒 + 20 毫秒 + 1230微秒 = 2.021230 秒。
-
to_char 的星期幾的編號(參閱 'D' 格式化模式)與 extract 的不同。
Table 9-23 顯示了 可以用於數值格式化的模版模式。
Table 9-23. 用於數值格式化的模板模式
模式 | 描述 |
---|---|
9 | 帶有指定數值位數的值 |
0 | 帶前導零的值 |
. (句點) | 小數點 |
, (逗號) | 分組(千)分隔符 |
PR | 尖括號內負值 |
S | 帶符號的數值(使用區域設置) |
L | 貨幣符號(使用區域設置) |
D | 小數點(使用區域設置) |
G | 分組分隔符(使用區域設置) |
MI | 在指明的位置的負號(如果數字 < 0) |
PL | 在指明的位置的正號(如果數字 > 0) |
SG | 在指明的位置的正/負號 |
RN | 羅馬數字(輸入在 1 和 3999 之間) |
TH 或 th | 序數後綴 |
V | 移動指定位(小數)(參閱註解) |
EEEE | 科學記數。(現在還未實現) |
數字格式化的用法須知:
-
使用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 是不允許的)。
Table 9-24 顯示了 一些使用 to_char 函數的用法。
Table 9-24. 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' |