9.8. データ型書式設定関数

PostgreSQLの書式設定関数は多彩なデータ型(日付/時刻データ型、整数データ型、浮動小数点数データ型、数値データ型)を整形された文字列に変換したり、整形された文字列を特定のデータ型に変換する強力なツールの一式を提供しています。表9-20にこれらを列挙しています。これら関数は共通の呼び出し規約を踏襲しています。最初の引数は整形される値で2番目の引数は入力書式または出力書式を定義するテンプレートです。

to_timestamp関数はUnix時刻からtimestamp with time zoneに変換するただ一つのdouble precision引数を取ることもできます。(int 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 zoneUNIX時刻をタイムスタンプに変換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時からの秒数(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年の下3桁
YY年の下2桁
Y年の下1桁<
IYYYISO年(4以上の桁)
IYYISO年の下3桁
IYISO年の下2桁
IISO年の下1桁
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文字。翻訳された場合は長さは可変です。)
DDD1年通算の日にち番号(001〜366)
DD1月通算の日にち番号(01〜31)
D1週通算の日にち番号(1〜7:日曜日=1)
W月中の週番号(1〜5)(その月の初日がある週が第1週)
WW年間を通じた週番号(1〜53)(元旦のある週が第1週)
IWISO 週番号(新年の最初の木曜日がある週が第1週)
CC世紀(2桁。21世紀は2001-01-01から始まります。)
Jユリウス日(紀元前4713年1月1日からの通算経過日) [訳注:原文では4712BCとなっていますが、修正しています]
Qquarter(四半期)
RMローマ数字による月(I〜XII:I=1月)(大文字)
rmローマ数字による月(i〜xii:i=1月)(小文字)
TZ時間帯名(大文字)
tz時間帯名(小文字)

ある種の修飾子はどのようなテンプレートパターンに対しても、その振舞いを変更するために適用することができます。例えば、FMMonthFM修飾子の付いたMonthパターンです。表9-22に、日付/時刻書式の修飾子パターンを示します。

表 9-22. 日付/時刻書式用のテンプレートパターン修飾子

修飾子説明
FM接頭辞字詰めモード(空白およびゼロのパディングを無効)FMMonth
TH接尾辞大文字の序数を追加DDTH
th接尾辞小文字の序数を追加DDth
FX接頭辞固定書式のグローバルオプション(使用上の注意事項を参照)FX Month DD Day
TM prefix翻訳モード(lc_messagesに基付き、翻訳された日付、付を表示します。)TMMonth
SP接尾辞スペルモード(未実装)DDSP

日付/時刻型書式の使用上の注意事項は次のとおりです。

表9-23に、数値型の値の書式設定に使用可能なテンプレートパターンを示します。

表 9-23. 数値書式用のテンプレートパターン

パターン説明
9指定された桁数での値
0前にゼロが付いた値
.(句読点)小数点
,(コンマ)千単位で区切る符号
PR負の値の角括弧表示
S(ロケール使用の)記号付き値
L(ロケール使用の)通貨記号
D(ロケール使用の)小数点
G(ロケール使用の)グループ区切り文字
MI(数値 < 0であれば)指定位置にマイナス記号
PL(数値 > 0であれば)指定位置にプラス記号
SG指定された位置にプラス/マイナス記号
RN(1〜3999の入力値による)ローマ数字
TH もしくは th序数接尾辞
Vn 桁シフト(注意事項を参照)
EEEE科学技術表記法(未実装)

数値型書式の使用上の注意事項は次のとおりです。

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