postgreSQL數據類型格式化函數

9.8. 數據類型格式化函數

PostgreSQL 格式化函數提供一套有效的工具用於把各種數據類型轉換成格式化的字符串以及反過來從格式化的字符串轉換成指定的數據類型。表9-20列出了這些函數。這些函數都遵循一個公共的調用習慣：第一個參數是待格式化的值，而第二個是定義輸出或輸出格式的模板。

to_timestamp 函數也能接受一個 double precision 參數，把它從 Unix 紀元轉換成 timestamp with time zone。Integer 類型的 Unix 紀元隱含地轉換成了 double precision 。

表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(200120400)


在輸出模板字符串裏(對 to_char 而言)，該函數族可以識別一些特定的模式，並且把待格式化的數值正確地格式化成相應的數據。任何不屬於模板模式的文本都簡單地逐字拷貝。同樣，在一個輸入模板字符串裏(對除 to_char 外的任何東西)，模板模式標識要查看的輸入數據字符串，並且將在該位置尋找數值。

表9-21顯示了可以用於格式化日期和時間值的模版。

表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年的最後三位
IY ISO年的最後兩位
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 位)(20 世紀從 2001-01-01 開始)
J 儒略日(自公元前 4712 年 1 月 1 日來的天數)
Q 季度
RM 羅馬數字的月份(I-XII ；I=JAN)(大寫)
rm 羅馬數字的月份(I-XII ；I=JAN)(小寫)
TZ 時區名(大寫)
tz 時區名(小寫)


有一些修飾詞可以應用於模板來修改它們的行爲。比如，FMMonth 就是帶着 FM 前綴的 Month 模式。表9-22顯示了用於日期/時間格式化的修飾詞模式。

表9-22. 日期/時間格式化的模板模式修飾詞修飾符 描述 例子
FM 前綴 填充模式(抑制填充空白和零) FMMonth
TH 後綴 大寫順序數後綴 DDTH
th 後綴 小寫順序數後綴 DDth
FX 前綴 固定格式全局選項(見用法須知) FX Month DD Day
TM 前綴 翻譯模式(基於 lc_messages 顯示本地化的日期和月份名) TMMonth
SP 後綴 拼寫模式(還未實現) DDSP


日期/時間格式化的用法須知：

FM 抑制前導的零或尾隨的空白，如果沒有使用它的話，會在輸出中增加這些填充最終把輸出變成固定寬度的模式。

TM 不包含結尾空白。

如果沒有使用 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 不會。

如果你想在輸出裏有雙引號，那麼你必須在它們前面放雙反斜槓，比如 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 計算。

將字符串轉化爲 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 的星期編號(參閱'D'格式化模式)與 extract 的不同。

to_char(interval) 將 HH 和 HH12 格式化爲一日之內的小時數，而 HH24 可以輸出超出一日的小時數，比如 >24 。

表9-23 shows the template patterns available for formatting numeric values

表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 是不允許的)。

表9-24 顯示了一些 to_char 函數的用法。

表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'

 本頁地址：http://zonghe.17xie.com/book/10514601/33917.html