日付と時刻の入力は、ISO 8601、SQL互換、伝統的なPOSTGRES、その他を含むほとんどの適正とみなされる書式を受け付けます。 一部の書式では日付の入力における日-月-年の順序が曖昧ですが、これらのフィールドの期待される順序を指定する方式が提供されています。 DateStyleパラメータをMDYに設定すれば、月日年という順で解釈され、DMYに設定すれば日月年という順で、YMDに設定すれば年月日という順で解釈されます。

PostgreSQLは日付/時刻入力の取扱いにおいて標準SQLの要求よりも柔軟です。 日付/時刻の入力における厳密な構文解析規則と、月および週、そして時間帯を含む使用可能なテキストフィールドに関しては付録Bを参照してください。

日付や時刻リテラルの入力では、テキスト文字列のように、単一引用符で囲む必要があることを思い出してください。 詳細は4.1.2.7を参照してください。 SQLでは下記の構文が要求されます。

type [ (p) ] 'value'

ここで、pは秒フィールドの小数点以下の桁数を与えるオプションの精度の指定です。 精度はtime、timestampおよびinterval型に対して0から6の範囲で設定できます。 値の許容範囲は既に説明しています。 定数指定において精度指定がない場合は、リテラル値の精度がデフォルトとして使われます(ただし、６桁を超えることはありません)。

1999-01-08 04:05:06

1999-01-08 04:05:06 -8:00

January 8 04:05:06 1999 PST

TIMESTAMP '2004-10-19 10:23:54'

TIMESTAMP '2004-10-19 10:23:54+02'

TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02'

日付/時刻型の出力書式は、ISO 8601、SQL（Ingres）、伝統的なPOSTGRES（Unix date書式）またはGermanの４つのいずれかに設定できます。 デフォルトはISO書式です。 （標準SQLではISO 8601書式の使用が定められています。 「SQL」という出力書式名は歴史的な事故です。） 表 8.14に各出力書式の例を示します。 dateとtimeの書式は、例にあるとおり、それぞれ日付と時刻の部分です。しかし、POSTGRESではISO書式の日付部分のみを出力します。(YMDやMDYの場合12-17-1997を返し、DMYの場合17-12-1997を返します。)

SQLとPOSTGRESでは、DMYフィールド順が指定された場合は月の前に日が現れます。 指定がなければ日の前に月が現れます。 （この設定が入力値の解釈にどう影響を与えるのかについては8.5.1を参考にしてください）。 表 8.15に例を示します。

ISO形式ではタイムゾーンはUTCからの符号付きの数値で表現され、グリニッジより東の地域では正の符号が使用されます。 オフセットは時間の整数倍であればhh（時間のみ）、分の整数倍であればhh:mm、それ以外の場合は、hh:mm:ssで表現されます。 （三番目のケースは現代のどのタイムゾーンの標準でもありえませんが、タイムゾーンが標準化される前に適用されたタイムスタンプで動いている場合に現れる可能性があります。） 他の日付スタイルでは、現在の地域で一般的に使われている場合、タイムゾーンは省略形で表現されます。 それ以外の場合はISO 8601の基本フォーマット（hhやhhmm）の符号付き数値のオフセットとして表示されます。

ユーザはSET DATESTYLEコマンド、postgresql.conf構成ファイルのDateStyleパラメータ、そしてサーバかクライアントのPGDATESTYLE環境変数を使用して、日付/時刻の様式を選択することができます。

日付/時刻出力のより柔軟な書式設定方法として、書式設定関数to_char（9.8を参照）を使用することもできます。

時間帯および時間帯の取り決めは地球の幾何学的要素のみでなく政治的決定に影響されます。 世界にまたがる時間帯は1900年代に標準化されたようですが、特に夏時間規則の点で、勝手に変更する傾向が続いています。 PostgreSQLは歴史的な時間帯ルールについての情報に、広く使われているIANA時間帯データベースを使用します。 将来の時間は、ある与えられた時間帯に対する最新の既知のルールが、将来長きに渡りそのまま遵守が継続されるということを前提としています。

PostgreSQLは典型的な使用法については標準SQLへの互換性に対し最大限の努力をしています。 しかし、標準SQLには、日付と時刻のデータ型と機能に関する混乱が見受けられます。 2つの明らかな問題点を以下に示します。

このような問題を解決するためには、時間帯を使用する際に日付と時刻の両方を保持できる日付/時刻データ型を使用することを勧めます。 time with time zone型の使用はお勧めしません （もっともPostgreSQLでは、旧式のアプリケーションや、標準SQLとの互換性のために、time with time zone型の使用をサポートしています）。 PostgreSQLは、日付または時刻のみを保持するデータ型のすべては使用中の時間帯であると前提しています。

すべての時間帯付きの日付と時刻はUTCで内部的に保存されます。 これらはクライアントに表示される前にTimeZone設定パラメータで指定された時間帯におけるローカル時間に変換されます。

PostgreSQLでは、3つの形式で時間帯を指定することができます。

一言で言うと、これは省略形と正式名称との差異です。 省略形はUTCから固定したオフセットを表わすのに対して、多くの正式名称はローカルの夏時間規定を暗示するので、2つのUTCオフセットがあるかもしれません。 例えば2014-06-04 12:00 America/New_Yorkはニューヨークの正午を示しますが、これはこの日について言えば東部夏時間(UTC-4)です。 つまり2014-06-04 12:00 EDTはこれと同時刻を示します。 しかし、2014-06-04 12:00 ESTは、その日に夏時間が使用されていたかどうかに関わらず、東部標準時間(UTC-5)での正午を示します。

問題を更に複雑にしているのは、一部の管轄は同じ略号を使って、年によって異なるUTCオフセットを表していることです。 例えばモスクワではMSKはある年ではUTC+3を意味しますが、別の年ではUTC+4を意味します。 PostgreSQLではそのような略号について、指定の日に何を意味していたか（あるいは最も最近にどういう意味だったか）に従って解釈します。 しかし、ESTの例にあるように、必ずしもその日付における地方常用時を示しているとは限りません。

すべての場合において、時間帯名や略号は大文字小文字の区別なく認識されます。 （これはPostgreSQLの8.2より前のバージョンからの変更です。 以前は、文脈によって大文字小文字が区別される場合と、されない場合がありました。）

時間帯名、省略形のどちらもサーバ内に組み込まれるわけではありません。 インストールディレクトリの.../share/timezone/および.../share/timezonesets/の下に保存される構成ファイルから取得されます（B.4を参照ください）。

TimeZoneはpostgresql.confファイルや第19章で説明する他の標準的な方法で設定することができます。 以下に、いくつか特別な設定方法を示します。

interval値は以下の冗長な構文を使って記述されます。

[@] quantity unit [quantity unit...] [direction]

ここで、quantityは（符号付き）時間量、unit（単位）はmicrosecond、millisecond、second（秒）、minute（分）、hour（時）、day（日）、week（週）、month（月）、year（年）、decade（10年単位）、century（100年単位）、millennium（1000年単位）あるいはこれらの単位の簡略形または複数形です。 direction（方向）はagoもしくは空です。 アットマーク（@）はオプションで、付けても付けなくても構いません。 異なる単位における時間量は適切に符号を考慮して暗黙的に足されます。 agoはすべてのフィールドの正負を逆にします。 この構文はまた、IntervalStyleがpostgres_verboseに設定されている場合に時間間隔の出力でも使用されます。

日、時、分、および秒の時間量は明示的に単位を指定しなくても構いません。 例えば、'1 12:59:10'は'1 day 12 hours 59 min 10 sec'（1日と12時間59分10秒）と解釈されます。 また年と月の組み合わせはダッシュを使って指定することができます。 例えば、'200-10'は'200 years 10 months'（200年と10か月）と解釈されます。 （実際のところ、標準SQLで許されている簡略形はこれらだけです。 そしてIntervalStyleがsql_standardに設定されている場合には、これらが出力で使用されます。）

標準の4.4.3.2節の「指定文字付書式」または4.4.3.3節の「代替書式」のどちらかを使用して、時間間隔値はISO 8601時間間隔として書くこともできます。 指定文字付の書式は以下のようなものです。

P quantity unit [ quantity unit ...] [ T [ quantity unit ...]]

文字列はPで始まらなければならず、また、日と時間を区切るTを含めることができます。 利用可能な単位の省略形を表 8.16に示します。 単位は省略しても構いませんし、任意の順番で指定できますが、1日より小さな単位はTの後に書かなければなりません。 特にMの意味はTの前にあるか後にあるかに依存します。

別の書式を示します。

P [ years-months-days ] [ T hours:minutes:seconds ]

上の代替書式では、文字列はPから始まらなければなりません。 そして、Tは時間間隔の日付部分と時刻部分とを分割します。 値はISO 8601日付と同様の数字で指定されます。

fields指定を使って時間間隔定数を記述する場合、または、fields仕様で定義された時間間隔列に文字列を割り当てる場合、マークされていない時間量の解釈はfieldsに依存します。 例えばINTERVAL '1' YEARは1年と解釈され、一方でINTERVAL '1'は1秒と解釈されます。 同時に、fields仕様によって許可される最下位フィールドの「右側の」フィールド値は警告なしに破棄されます。 例えば、INTERVAL '1 day 2:03:04' HOUR TO MINUTEと書くことで、二番目のフィールドは削除されますが、日付フィールドは削除されません。

標準SQLに従うと、時間間隔値のフィールドはすべて同じ符号を持たなければなりません。 このため、先頭の負の符号はすべてのフィールドに適用されます。 例えば時間間隔リテラル'-1 2:03:04'の負の符号は、日付部分にも時、分、秒部分にも適用されます。 PostgreSQLではフィールドに異なる符号を持たせることができます。 また伝統的にテキスト形式表現における各フィールドは独立した符号を持つものとして扱われます。 このため、この例では時、分、秒部分は正であるとみなされます。 IntervalStyleがsql_standardに設定されている場合、先頭の符号はすべてのフィールドに適用されるものとみなされます（ただし他に符号がない場合のみです）。 さもなくば、伝統的なPostgreSQLの解釈が使用されます。 あいまいさを防ぐために、負のフィールドがある場合には個別に明示的な符号を付けることを勧めます。

内部的には、interval値は3つの整数フィールドとして格納されます。 月、日、マイクロ秒です。 月の日数は変化したり、 夏時間の移行が含まれる場合は1日が23時間または25時間になったりするため、これらのフィールドは分けて保持されます。 他の単位を使用する時間間隔の入力文字列は、このフォーマットに正規化され、出力用に標準化された方法で再再構成されます。例えば以下のとおりです。

SELECT '2 years 15 months 100 weeks 99 hours 123456789 milliseconds'::interval;
               interval
---------------------------------------
 3 years 3 mons 700 days 133:17:36.789

ここでは、週は「7日」と理解され、別々に保持されていますが、小さな時間単位と大きな時間単位は結合され、正規化されています。

入力フィールドの値には小数部分が含まれる場合があります。例えば、'1.5 weeks'や'01:02:03.45'などです。 しかし、intervalは内部的に整数フィールドでのみ格納されるため、小数の位はより小さな単位に変換する必要があります。 月より大きな小数部分の位は月の整数に丸められます。例えば、'1.5 years'は'1 year 6 mons'になります。 週と日の小数部分は、1ヶ月は30日、1日は24時間と想定して整数の日数やマイクロ秒として計算されます。例えば'1.75 months'は1 mon 22 days 12:00:00になります。 出力では秒だけが小数として表示されます。

表 8.17は有効なinterval入力のいくつかの例を示しています。

前述のように、PostgreSQLはinterval値を月、日、マイクロ秒として格納します。 出力の場合、monthsフィールドは12で除算して年と月に変換されます。 daysフィールドはそのまま表示されます。 microseconds フィールドは、時間、分、秒、および小数の秒に変換されます。 したがって、月、分、秒はそれぞれ0~11、0~59、0~59の範囲を超えることはありませんが、表示される年、日、時間のフィールドは非常に大きくなる可能性があります。 （大きな日数または時間の値を次に高いフィールドに移すことが望ましい場合は、justify_daysおよびjustify_hours関数を使用できます）。

時間間隔型の出力書式は、SET intervalstyleコマンドを使用して、sql_standard、postgres、postgres_verboseまたはiso_8601の４つのうちの１つを設定できます。 デフォルトはpostgres書式です。 表 8.18はそれぞれの出力形式を示した例です。

sql_standard形式は、時間間隔値が標準制約（構成要素に正負が混在していない年数と月数のみ、または日数と時間のみ）を満足する場合、時間間隔リテラル文字列に対し標準SQLに準拠している出力を作成します。 それ以外の場合、出力は、標準的な年数-月数のリテラル文字列の後に日数-時間のリテラル文字列が続いたものになり、正負混在した時間間隔のあいまいさを無くすために明示的な符号が付加されます。

postgres書式の出力は、DateStyleパラメータがISOに設定されたとき、PostgreSQL 8.4より前のリリースと一致します。

postgres_verbose書式の出力は、DateStyleパラメータがISO以外に設定されたとき、PostgreSQL 8.4より前のリリースと一致します。

iso_8601書式の出力はISO 8601 標準の4.4.3.2節に記述の「format with designators（指名付き書式）」に一致します。