Date and time input is accepted in almost any reasonable format, including ISO 8601, <acronym>SQL</acronym>-compatible, traditional <productname>POSTGRES</productname>, and others. For some formats, ordering of day, month, and year in date input is ambiguous and there is support for specifying the expected ordering of these fields. Set the <xref linkend="guc-datestyle"/> parameter to <literal>MDY</literal> to select month-day-year interpretation, <literal>DMY</literal> to select day-month-year interpretation, or <literal>YMD</literal> to select year-month-day interpretation. 日付と時刻の入力は、ISO 8601、SQL互換、伝統的なPOSTGRES、その他を含むほとんどの適正とみなされる書式を受け付けます。 一部の書式では日付の入力における日-月-年の順序が曖昧ですが、これらのフィールドの期待される順序を指定する方式が提供されています。 DateStyleパラメータをMDYに設定すれば、月日年という順で解釈され、DMYに設定すれば日月年という順で、YMDに設定すれば年月日という順で解釈されます。

<productname>PostgreSQL</productname> is more flexible in handling date/time input than the <acronym>SQL</acronym> standard requires. See <xref linkend="datetime-appendix"/> for the exact parsing rules of date/time input and for the recognized text fields including months, days of the week, and time zones. PostgreSQLは日付/時刻入力の取扱いにおいて標準SQLの要求よりも柔軟です。 日付/時刻の入力における厳密な構文解析規則と、月および週、そして時間帯を含む使用可能なテキストフィールドに関しては付録Bを参照してください。

Remember that any date or time literal input needs to be enclosed in single quotes, like text strings. Refer to <xref linkend="sql-syntax-constants-generic"/> for more information. <acronym>SQL</acronym> requires the following syntax 日付や時刻リテラルの入力では、テキスト文字列のように、単一引用符で囲む必要があることを思い出してください。 詳細は4.1.2.7を参照してください。 SQLでは下記の構文が要求されます。

type [ (p) ] 'value'

where <replaceable>p</replaceable> is an optional precision specification giving the number of fractional digits in the seconds field. Precision can be specified for <type>time</type>, <type>timestamp</type>, and <type>interval</type> types, and can range from 0 to 6. If no precision is specified in a constant specification, it defaults to the precision of the literal value (but not more than 6 digits). ここで、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'

The output format of the date/time types can be set to one of the four styles ISO 8601, <acronym>SQL</acronym> (Ingres), traditional <productname>POSTGRES</productname> (Unix <application>date</application> format), or German. The default is the <acronym>ISO</acronym> format. (The <acronym>SQL</acronym> standard requires the use of the ISO 8601 format. The name of the <quote>SQL</quote> output format is a historical accident.) <xref linkend="datatype-datetime-output-table"/> shows examples of each output style. The output of the <type>date</type> and <type>time</type> types is generally only the date or time part in accordance with the given examples. However, the <productname>POSTGRES</productname> style outputs date-only values in <acronym>ISO</acronym> format. 日付/時刻型の出力書式は、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を返します。) However以下が原文のみだとわかりにくかったため http://www.postgresql.org/message-id/2598E90D3D534989905115C5C1172679@maumau より補足を追加

In the <acronym>SQL</acronym> and POSTGRES styles, day appears before month if DMY field ordering has been specified, otherwise month appears before day. (See <xref linkend="datatype-datetime-input"/> for how this setting also affects interpretation of input values.) <xref linkend="datatype-datetime-output2-table"/> shows examples. SQLとPOSTGRESでは、DMYフィールド順が指定された場合は月の前に日が現れます。 指定がなければ日の前に月が現れます。 （この設定が入力値の解釈にどう影響を与えるのかについては8.5.1を参考にしてください）。 表 8.15に例を示します。

In the <acronym>ISO</acronym> style, the time zone is always shown as a signed numeric offset from UTC, with positive sign used for zones east of Greenwich. The offset will be shown as <replaceable>hh</replaceable> (hours only) if it is an integral number of hours, else as <replaceable>hh</replaceable>:<replaceable>mm</replaceable> if it is an integral number of minutes, else as <replaceable>hh</replaceable>:<replaceable>mm</replaceable>:<replaceable>ss</replaceable>. (The third case is not possible with any modern time zone standard, but it can appear when working with timestamps that predate the adoption of standardized time zones.) In the other date styles, the time zone is shown as an alphabetic abbreviation if one is in common use in the current zone. Otherwise it appears as a signed numeric offset in ISO 8601 basic format (<replaceable>hh</replaceable> or <replaceable>hhmm</replaceable>). ISO形式ではタイムゾーンはUTCからの符号付きの数値で表現され、グリニッジより東の地域では正の符号が使用されます。 オフセットは時間の整数倍であればhh(時間のみ)、分の整数倍であればhh:mm、それ以外の場合は、hh:mm:ssで表現されます（三番目のケースは現代のどのタイムゾーンの標準でもありえませんが、タイムゾーンが標準化される前に適用されたタイムスタンプで動いている場合に現れる可能性があります）。 他の日付スタイルでは、現在の地域で一般的に使われている場合、タイムゾーンは省略形で表現されます。 それ以外の場合はISO 8601の基本フォーマット(hhやhhmm)の符号付き数値のオフセットとして表示されます。

The date/time style can be selected by the user using the <command>SET datestyle</command> command, the <xref linkend="guc-datestyle"/> parameter in the <filename>postgresql.conf</filename> configuration file, or the <envar>PGDATESTYLE</envar> environment variable on the server or client. ユーザはSET DATESTYLEコマンド、postgresql.conf構成ファイルのDateStyleパラメータ、そしてサーバかクライアントのPGDATESTYLE環境変数を使用して、日付/時刻の様式を選択することができます。

The formatting function <function>to_char</function> (see <xref linkend="functions-formatting"/>) is also available as a more flexible way to format date/time output. 日付/時刻出力のより柔軟な書式設定方法として、書式設定関数to_char（9.8を参照）を使用することもできます。

Time zones, and time-zone conventions, are influenced by political decisions, not just earth geometry. Time zones around the world became somewhat standardized during the 1900s, but continue to be prone to arbitrary changes, particularly with respect to daylight-savings rules. <productname>PostgreSQL</productname> uses the widely-used IANA (Olson) time zone database for information about historical time zone rules. For times in the future, the assumption is that the latest known rules for a given time zone will continue to be observed indefinitely far into the future. 時間帯および時間帯の取り決めは地球の幾何学的要素のみでなく政治的決定に影響されます。 世界にまたがる時間帯は1900年代に標準化されたようですが、特に夏時間規則の点で、勝手に変更する傾向が続いています。 PostgreSQLは歴史的な時間帯ルールについての情報に、広く使われているIANA時間帯データベースを使用します。 将来の時間は、ある与えられた時間帯に対する最新の既知のルールが、将来長きに渡りそのまま遵守が継続されるということを前提としています。

<productname>PostgreSQL</productname> endeavors to be compatible with the <acronym>SQL</acronym> standard definitions for typical usage. However, the <acronym>SQL</acronym> standard has an odd mix of date and time types and capabilities. Two obvious problems are: PostgreSQLは典型的な使用法については標準SQLへの互換性に対し最大限の努力をしています。 しかし、標準SQLには、日付と時刻のデータ型と機能に関する混乱が見受けられます。 2つの明らかな問題点を以下に示します。

To address these difficulties, we recommend using date/time types that contain both date and time when using time zones. We do <emphasis>not</emphasis> recommend using the type <type>time with time zone</type> (though it is supported by <productname>PostgreSQL</productname> for legacy applications and for compliance with the <acronym>SQL</acronym> standard). <productname>PostgreSQL</productname> assumes your local time zone for any type containing only date or time. このような問題を解決するためには、時間帯を使用する際に日付と時刻の両方を保持できる日付/時刻データ型を使用することを勧めます。 time with time zone型の使用はお勧めしません （もっともPostgreSQLでは、旧式のアプリケーションや、標準SQLとの互換性のために、time with time zone型の使用をサポートしています）。 PostgreSQLは、日付または時刻のみを保持するデータ型のすべては使用中の時間帯であると前提しています。

All timezone-aware dates and times are stored internally in <acronym>UTC</acronym>. They are converted to local time in the zone specified by the <xref linkend="guc-timezone"/> configuration parameter before being displayed to the client. すべての時間帯付きの日付と時刻はUTCで内部的に保存されます。 これらはクライアントに表示される前にTimeZone設定パラメータで指定された時間帯におけるローカル時間に変換されます。

<productname>PostgreSQL</productname> allows you to specify time zones in three different forms: PostgreSQLでは、3つの形式で時間帯を指定することができます。

In short, this is the difference between abbreviations and full names: abbreviations represent a specific offset from UTC, whereas many of the full names imply a local daylight-savings time rule, and so have two possible UTC offsets. As an example, <literal>2014-06-04 12:00 America/New_York</literal> represents noon local time in New York, which for this particular date was Eastern Daylight Time (UTC-4). So <literal>2014-06-04 12:00 EDT</literal> specifies that same time instant. But <literal>2014-06-04 12:00 EST</literal> specifies noon Eastern Standard Time (UTC-5), regardless of whether daylight savings was nominally in effect on that date. 一言で言うと、これは省略形と正式名称との差異です。 省略形は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)での正午を示します。

To complicate matters, some jurisdictions have used the same timezone abbreviation to mean different UTC offsets at different times; for example, in Moscow <literal>MSK</literal> has meant UTC+3 in some years and UTC+4 in others. <productname>PostgreSQL</productname> interprets such abbreviations according to whatever they meant (or had most recently meant) on the specified date; but, as with the <literal>EST</literal> example above, this is not necessarily the same as local civil time on that date. 問題を更に複雑にしているのは、一部の管轄は同じ略号を使って、年によって異なるUTCオフセットを表していることです。 例えばモスクワではMSKはある年ではUTC+3を意味しますが、別の年ではUTC+4を意味します。 PostgreSQLではそのような略号について、指定の日に何を意味していたか（あるいは最も最近にどういう意味だったか）に従って解釈します。 しかし、ESTの例にあるように、必ずしもその日付における地方常用時を示しているとは限りません。

In all cases, timezone names and abbreviations are recognized case-insensitively. (This is a change from <productname>PostgreSQL</productname> versions prior to 8.2, which were case-sensitive in some contexts but not others.) すべての場合において、時間帯名や略号は大文字小文字の区別なく認識されます。 （これはPostgreSQLの8.2より前のバージョンからの変更です。 以前は、文脈によって大文字小文字が区別される場合と、されない場合がありました。）

Neither timezone names nor abbreviations are hard-wired into the server; they are obtained from configuration files stored under <filename>.../share/timezone/</filename> and <filename>.../share/timezonesets/</filename> of the installation directory (see <xref linkend="datetime-config-files"/>). 時間帯名、省略形のどちらもサーバ内に組み込まれるわけではありません。 インストールディレクトリの.../share/timezone/および.../share/timezonesets/の下に保存される構成ファイルから取得されます（B.4を参照ください）。

The <xref linkend="guc-timezone"/> configuration parameter can be set in the file <filename>postgresql.conf</filename>, or in any of the other standard ways described in <xref linkend="runtime-config"/>. There are also some special ways to set it: TimeZoneはpostgresql.confファイルや第20章で説明する他の標準的な方法で設定することができます。 以下に、いくつか特別な設定方法を示します。

<type>interval</type> values can be written using the following verbose syntax: interval値は以下の冗長な構文を使って記述されます。

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

where <replaceable>quantity</replaceable> is a number (possibly signed); <replaceable>unit</replaceable> is <literal>microsecond</literal>, <literal>millisecond</literal>, <literal>second</literal>, <literal>minute</literal>, <literal>hour</literal>, <literal>day</literal>, <literal>week</literal>, <literal>month</literal>, <literal>year</literal>, <literal>decade</literal>, <literal>century</literal>, <literal>millennium</literal>, or abbreviations or plurals of these units; <replaceable>direction</replaceable> can be <literal>ago</literal> or empty. The at sign (<literal>@</literal>) is optional noise. The amounts of the different units are implicitly added with appropriate sign accounting. <literal>ago</literal> negates all the fields. This syntax is also used for interval output, if <xref linkend="guc-intervalstyle"/> is set to <literal>postgres_verbose</literal>. ここで、quantityは（符号付き）時間量、unit（単位）はmicrosecond、millisecond、second（秒）、minute（分）、hour（時）、day（日）、week（週）、month（月）、year（年）、decade（10年単位）、century（100年単位）、millennium（1000年単位）あるいはこれらの単位の簡略形または複数形です。 direction（方向）はagoもしくは空です。 アットマーク（@）はオプションで、付けても付けなくても構いません。 異なる単位における時間量は適切に符号を考慮して暗黙的に足されます。 agoはすべてのフィールドの正負を逆にします。 この構文はまた、IntervalStyleがpostgres_verboseに設定されている場合に時間間隔の出力でも使用されます。

Quantities of days, hours, minutes, and seconds can be specified without explicit unit markings. For example, <literal>'1 12:59:10'</literal> is read the same as <literal>'1 day 12 hours 59 min 10 sec'</literal>. Also, a combination of years and months can be specified with a dash; for example <literal>'200-10'</literal> is read the same as <literal>'200 years 10 months'</literal>. (These shorter forms are in fact the only ones allowed by the <acronym>SQL</acronym> standard, and are used for output when <varname>IntervalStyle</varname> is set to <literal>sql_standard</literal>.) 日、時、分、および秒の時間量は明示的に単位を指定しなくても構いません。 例えば、'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に設定されている場合には、これらが出力で使用されます。）

Interval values can also be written as ISO 8601 time intervals, using either the <quote>format with designators</quote> of the standard's section 4.4.3.2 or the <quote>alternative format</quote> of section 4.4.3.3. The format with designators looks like this: 標準の4.4.3.2節の「指定文字付書式」または4.4.3.3節の「代替書式」のどちらかを使用して、時間間隔値はISO 8601時間間隔として書くこともできます。 指定文字付の書式は以下のようなものです。

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

The string must start with a <literal>P</literal>, and may include a <literal>T</literal> that introduces the time-of-day units. The available unit abbreviations are given in <xref linkend="datatype-interval-iso8601-units"/>. Units may be omitted, and may be specified in any order, but units smaller than a day must appear after <literal>T</literal>. In particular, the meaning of <literal>M</literal> depends on whether it is before or after <literal>T</literal>. 文字列はPで始まらなければならず、また、日と時間を区切るTを含めることができます。 利用可能な単位の省略形を表 8.16に示します。 単位は省略しても構いませんし、任意の順番で指定できますが、1日より小さな単位はTの後に書かなければなりません。 特にMの意味はTの前にあるか後にあるかに依存します。

In the alternative format: 別の書式を示します。

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

the string must begin with <literal>P</literal>, and a <literal>T</literal> separates the date and time parts of the interval. The values are given as numbers similar to ISO 8601 dates. 上の代替書式では、文字列はPから始まらなければなりません。 そして、Tは時間間隔の日付部分と時刻部分とを分割します。 値はISO 8601日付と同様の数字で指定されます。

When writing an interval constant with a <replaceable>fields</replaceable> specification, or when assigning a string to an interval column that was defined with a <replaceable>fields</replaceable> specification, the interpretation of unmarked quantities depends on the <replaceable>fields</replaceable>. For example <literal>INTERVAL '1' YEAR</literal> is read as 1 year, whereas <literal>INTERVAL '1'</literal> means 1 second. Also, field values <quote>to the right</quote> of the least significant field allowed by the <replaceable>fields</replaceable> specification are silently discarded. For example, writing <literal>INTERVAL '1 day 2:03:04' HOUR TO MINUTE</literal> results in dropping the seconds field, but not the day field. fields指定を使って時間間隔定数を記述する場合、または、fields仕様で定義された時間間隔列に文字列を割り当てる場合、マークされていない時間量の解釈はfieldsに依存します。 例えばINTERVAL '1' YEARは1年と解釈され、一方でINTERVAL '1'は1秒と解釈されます。 同時に、fields仕様によって許可される最下位フィールドの「右側の」フィールド値は警告なしに破棄されます。 例えば、INTERVAL '1 day 2:03:04' HOUR TO MINUTEと書くことで、二番目のフィールドは削除されますが、日付フィールドは削除されません。

According to the <acronym>SQL</acronym> standard all fields of an interval value must have the same sign, so a leading negative sign applies to all fields; for example the negative sign in the interval literal <literal>'-1 2:03:04'</literal> applies to both the days and hour/minute/second parts. <productname>PostgreSQL</productname> allows the fields to have different signs, and traditionally treats each field in the textual representation as independently signed, so that the hour/minute/second part is considered positive in this example. If <varname>IntervalStyle</varname> is set to <literal>sql_standard</literal> then a leading sign is considered to apply to all fields (but only if no additional signs appear). Otherwise the traditional <productname>PostgreSQL</productname> interpretation is used. To avoid ambiguity, it's recommended to attach an explicit sign to each field if any field is negative. 標準SQLに従うと、時間間隔値のフィールドはすべて同じ符号を持たなければなりません。 このため、先頭の負の符号はすべてのフィールドに適用されます。 例えば時間間隔リテラル'-1 2:03:04'の負の符号は、日付部分にも時、分、秒部分にも適用されます。 PostgreSQLではフィールドに異なる符号を持たせることができます。 また伝統的にテキスト形式表現における各フィールドは独立した符号を持つものとして扱われます。 このため、この例では時、分、秒部分は正であるとみなされます。 IntervalStyleがsql_standardに設定されている場合、先頭の符号はすべてのフィールドに適用されるものとみなされます（ただし他に符号がない場合のみです）。 さもなくば、伝統的なPostgreSQLの解釈が使用されます。 あいまいさを防ぐために、負のフィールドがある場合には個別に明示的な符号を付けることを勧めます。

Field values can have fractional parts: for example, <literal>'1.5 weeks'</literal> or <literal>'01:02:03.45'</literal>. However, because interval internally stores only three integer units (months, days, microseconds), fractional units must be spilled to smaller units. Fractional parts of units greater than months are rounded to be an integer number of months, e.g. <literal>'1.5 years'</literal> becomes <literal>'1 year 6 mons'</literal>. Fractional parts of weeks and days are computed to be an integer number of days and microseconds, assuming 30 days per month and 24 hours per day, e.g., <literal>'1.75 months'</literal> becomes <literal>1 mon 22 days 12:00:00</literal>. Only seconds will ever be shown as fractional on output. フィールドには'1.5weeks' や '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になります。 出力では秒だけが小数として表示されます。

<xref linkend="datatype-interval-input-examples"/> shows some examples of valid <type>interval</type> input. 表 8.17は有効なinterval入力のいくつかの例を示しています。

Internally <type>interval</type> values are stored as months, days, and microseconds. This is done because the number of days in a month varies, and a day can have 23 or 25 hours if a daylight savings time adjustment is involved. The months and days fields are integers while the microseconds field can store fractional seconds. Because intervals are usually created from constant strings or <type>timestamp</type> subtraction, this storage method works well in most cases, but can cause unexpected results: 内部的にintervalの値は月、日、マイクロ秒として格納されます。 これはひと月の日数は変化し、一日も夏時間への切り替えで23時間もしくは25時間になりうるからです。 マイクロ秒の桁は小数で格納できますが、月、日の桁は整数です。 時間の間隔は通常、文字列定数もしくはtimestampの引き算で生成されるため、この格納方式はほとんどのケースではうまくいきますが、予期しない結果を返すこともあります。 例：

SELECT EXTRACT(hours from '80 minutes'::interval);
 date_part
-----------
         1

SELECT EXTRACT(days from '80 hours'::interval);
 date_part
-----------
         0

Functions <function>justify_days</function> and <function>justify_hours</function> are available for adjusting days and hours that overflow their normal ranges. justify_days関数とjustify_hours関数は範囲から溢れた日と時間の補正に役立ちます。

The output format of the interval type can be set to one of the four styles <literal>sql_standard</literal>, <literal>postgres</literal>, <literal>postgres_verbose</literal>, or <literal>iso_8601</literal>, using the command <literal>SET intervalstyle</literal>. The default is the <literal>postgres</literal> format. <xref linkend="interval-style-output-table"/> shows examples of each output style. 時間間隔型の出力書式は、SET intervalstyleコマンドを使用して、sql_standard、postgres、postgres_verboseまたはiso_8601の４つのうちの１つを設定できます。 デフォルトはpostgres書式です。 表 8.18はそれぞれの出力形式を示した例です。

The <literal>sql_standard</literal> style produces output that conforms to the SQL standard's specification for interval literal strings, if the interval value meets the standard's restrictions (either year-month only or day-time only, with no mixing of positive and negative components). Otherwise the output looks like a standard year-month literal string followed by a day-time literal string, with explicit signs added to disambiguate mixed-sign intervals. sql_standard形式は、時間間隔値が標準制約（構成要素に正負が混在していない年数と月数のみ、または日数と時間のみ）を満足する場合、時間間隔リテラル文字列に対し標準SQLに準拠する出力を作成します。 それ以外の場合、出力は、標準的な年数-月数のリテラル文字列の後に日数-時間のリテラル文字列が続いたものになり、正負混在した時間間隔のあいまいさを無くすために明示的な符号が付加されます。

The output of the <literal>postgres</literal> style matches the output of <productname>PostgreSQL</productname> releases prior to 8.4 when the <xref linkend="guc-datestyle"/> parameter was set to <literal>ISO</literal>. postgres書式の出力は、DateStyleパラメータがISOに設定されたとき、PostgreSQL 8.4より前のリリースと一致します。

The output of the <literal>postgres_verbose</literal> style matches the output of <productname>PostgreSQL</productname> releases prior to 8.4 when the <varname>DateStyle</varname> parameter was set to non-<literal>ISO</literal> output. postgres_verbose書式の出力は、DateStyleパラメータがISO以外に設定されたとき、PostgreSQL 8.4より前のリリースと一致します。

The output of the <literal>iso_8601</literal> style matches the <quote>format with designators</quote> described in section 4.4.3.2 of the ISO 8601 standard. iso_8601書式の出力はISO 8601 標準の4.4.3.2節に記述の「format with designators（指名付き書式）」に一致します。