| PostgreSQL 8.0.0 中文文件（轉譯自 PostgreSQL 中國 製作的簡體中文版本） | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 9. 函數和操作符 | Fast Forward | Next |
PostgreSQL 格式化函數提供一套有效的工具用於把各種資料類型 （日期/時間，integer，floating point，numeric） 轉換成格式化的字元串以及反過來從格式化的字元串轉換成 指定的資料類型。 Table 9-20 列出了這些函數。 這些函數都遵循一個公共的調用習慣： 第一個參數是待格式化的值，而第二個是一個定義輸出格式的模板。
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_number(text, text) | numeric | 把字串轉換成 numeric | to_number('12,454.8-', '99G999D9S') |
警告：to_char(interval, text) 已經廢棄了，在新寫的代碼裡不應該再用了。在下一個版本裡它將被刪除。
在輸出模板字串裡（對 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時， 毫秒（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' |