數據類型格式化函數

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)
AMA.M.PMP.M. 正午標識(大寫)
ama.m.pmp.m. 正午標識(小寫)
Y,YYY 帶逗號的年(4 和更多位)
YYYY 年(4和更多位)
YYY 年的後三位
YY 年的後兩位
Y 年的最後一位
IYYY ISO 年(4位或更多位)
IYY ISO 年的最後 3 位
IY ISO 年的最後 2 位
I ISO 年的最後一位
BCB.C.ADA.D. 紀元標識(大寫)
bcb.c.ada.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_timestampto_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')

  • 在從字串向 timestampdate 轉換的時候, 如果有 YYYYYYY 或者 Y,YYY 字段, 那麼 CC 字段會被忽略。 如果 CCYY Y 一起使用, 那麼年份時用公式 (CC-1)*100+YY 計算的。

  • 將字串轉化爲timestamp時, 毫秒(MS)和微秒(US)都是用字串 的小數點後面的部分轉換的。比如 to_timestamp('12:3', 'SS:MS') 不是 3 毫秒, 而是 300,因爲轉換把它看做 12 + 0.3 秒。 這意味着對於格式 'SS:MS'而言,輸入值爲 12:312:3012: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 之間)
THth 序數後綴
V 移動指定位(小數)(參閱註解)
EEEE 科學記數。(現在還未實現)

數字格式化的用法須知:

  • 使用SGPL MI 生成的符號並不掛在數字上面; 比如, to_char(-12, 'S9999')生成 '  -12', 而to_char(-12, 'MI9999')生成 '-  12'。 Oracle 裏的實現不允許在 9 前面使用 MI,而是要求9MI 前面。

  • 9 聲明和 9 的個數 相同的數字位數的數值。如果某個數值位沒有數字,則輸出一個空白。

  • TH 不會轉換小於零的數值,也不會轉換小數。

  • PLSG THPostgreSQL 擴展。

  • 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'
發佈了42 篇原創文章 · 獲贊 18 · 訪問量 23萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章