PolarDB:日付 /時刻タイプ

日付 /時刻タイプ

time、timestamp、およびintervalは、秒フィールドに保持される分数桁数を指定するオプションの精度値pを受け入れます。 デフォルトでは、精度に明示的な制限はありません。 pの許容範囲は0から6です。

intervalタイプには、次のいずれかのフレーズを記述して、格納されたフィールドのセットを制限する追加オプションがあります。

年
月
デイ
時間
分
第2
月への年
DAY TO HOUR
分までの日
2日目
分までの時間
2番目の時間
分から2番目 

fieldsとpの両方が指定されている場合、精度は秒にのみ適用されるため、フィールドにはSECONDを含める必要があります。

タイムゾーンのタイプはSQL標準によって定義されていますが、この定義は有用性に疑問をもたらすプロパティを示しています。 ほとんどの場合、date、time、timestamp without time zone、およびtimestamp with time zoneの組み合わせは、任意のアプリケーションで必要とされる完全な範囲の日付 /時刻機能を提供する必要があります。

日付 /時刻入力

日付と時刻の入力は、ISO 8601、SQL互換、traditionalPOSTGRESなど、ほぼすべての妥当な形式で受け入れられます。 一部の形式では、日付入力における日、月、年の順序付けがあいまいであり、これらのフィールドの予想される順序付けを指定するサポートがあります。 DateStyleパラメーターをMDYに設定して、月-日-年の解釈を選択します。DMYは日-月-年の解釈を選択します。YMDは年-月-日の解釈を選択します。

PostgreSQLは、SQL標準が必要とするよりも日付 /時刻入力の処理において柔軟性があります。

日付または時刻のリテラル入力は、テキスト文字列のように一重引用符で囲む必要があることに注意してください。 SQLには次の構文が必要です

type [ (p) ] 'value'

ここで、pは秒フィールドの分数桁数を示すオプションの精度仕様です。 精度は、time、timestamp、およびintervalタイプに指定でき、0から6の範囲で指定できます。 定数指定で精度が指定されていない場合、デフォルト値はリテラル値の精度になります (ただし、6桁以下) 。

日付

日付入力

タイムズ

時刻タイプは、time [ () ] without time zoneとtime [ () ] with time zoneです。timeだけはtime without time zoneに相当します。

これらのタイプの有効な入力は、時刻とそれに続くオプションのタイムゾーンで構成されます。 入力にタイムゾーンが指定されている場合、time without time zoneは暗黙的に無視されます。 日付を指定することもできますが、America/New_Yorkなどの夏時間ルールを含むタイムゾーン名を使用する場合を除き、無視されます。 この場合、標準または夏時間が適用されるかどうかを判断するために、日付を指定する必要があります。 適切なタイムゾーンオフセットは、time with time zoneの値に記録され、保存されたまま出力されます。

時間入力

タイムゾーン入力

タイムスタンプ

タイムスタンプタイプの有効な入力は、日付と時刻の連結、オプションのタイムゾーン、オプションのADまたはBCの連結で構成されます。 (あるいは、AD /BCは時間帯の前に現れることができるが、これは好ましい順序ではない。) したがって:

1999-01-08 04:05:06

と:

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

はISO8601標準に従う有効な値です。 さらに、共通のフォーマット:

1月8日04:05:06 1999 PST

のみです。

SQLstandardは、timestamp without time zoneとtimestamp with time zone literalsを、"+" または "-" シンボルの存在と、時刻の後のタイムゾーンオフセットによって区別します。 したがって、標準によると、

タイムスタンプ '2004-10-19 10:23:54 '

はタイムスタンプなしのタイムゾーンです。

タイムスタンプ '2004-10-19 10:23:54 02 '

はタイムスタンプとタイムゾーンです。PostgreSQLneverは、そのタイプを決定する前にリテラル文字列の内容を調べます。したがって、上記の両方をタイムスタンプなしタイムゾーンとして扱います。 リテラルがtimestamp with time zoneとして扱われるようにするには、正しい明示的な型を指定します。

タイムゾーン付きタイムスタンプ '2004-10-19 10:23:54 02 '

timestamp without time zoneであると判断されたリテラルでは、PostgreSQLはタイムゾーンの表示を黙って無視します。 つまり、結果の値は、入力値の日付 /時刻フィールドから取得され、タイムゾーンに合わせて調整されません。

timestamp with time zoneの場合、内部に格納される値は常にUTC (Universal Coordinated Time、伝統的にグリニッジ標準時 (GMT) として知られています) です。 明示的なタイムゾーンが指定された入力値は、そのタイムゾーンの適切なオフセットを使用してUTCに変換されます。 入力文字列にタイムゾーンが指定されていない場合は、システムのTimeZoneパラメーターで指定されたタイムゾーンと見なされ、timezoneゾーンのオフセットを使用してUTCに変換されます。

timestamp with time zone値が出力されると、常にUTCから現在のtimezoneゾーンに変換され、そのゾーンの現地時間として表示されます。 別のタイムゾーンの時刻を表示するには、timezoneを変更するか、AT time zone構造を使用します。

timestamp without time zoneとtimestamp with time zoneの間の変換は、通常、timestamp without time zone値がtimezoneローカル時間として取得または指定されることを前提としています。 AT time zoneを使用して、別のタイムゾーンを変換に指定できます。

特別な値

PostgreSQLは、便宜上、いくつかの特別な日付 /時刻入力値をサポートします。 infinityと -infinityの値はシステム内で特別に表示され、変更されずに表示されます。ただし、その他の値は、読み取り時に通常の日付 /時刻値に変換される単なる表記の省略形です。 (特に、現在および関連する文字列は、読み取られるとすぐに特定の時間値に変換されます。) SQLコマンドで定数として使用する場合、これらの値はすべて単一引用符で囲む必要があります。

特別な日付 /時刻入力

次のSQL互換関数を使用して、対応するデータ型の現在の時刻値を取得することもできます。CURRENT_DATE、CURRENT_TIME、CURRENT_TIME、LOCALTIME、LOCALTIMESTAMP。 これらはSQL関数であり、データ入力文字列では認識されません。

日付 /時刻出力

日付 /時刻タイプの出力形式は、ISO 8601、SQL (Ingres) 、従来のPOSTGRES (Unix日付形式) 、またはドイツ語の4つのスタイルのいずれかに設定できます。 デフォルトはtheISOformatです。 (SQL標準は、ISO 8601フォーマットの使用を必要とする。 「SQL」出力形式の名前は、過去の事故です。各出力スタイルの例を次の表に示します。 日付および時間タイプの出力は、一般的に、与えられた例による日付または時間部分のみである。 ただし、POSTGRESスタイルはISO形式で日付のみの値を出力します。

日付 /時刻出力スタイル

日付注文規則

_charへのフォーマット機能は、日付 /時刻出力をより柔軟にフォーマットする方法としても利用できます。

タイムゾーン

タイムゾーンとタイムゾーンの慣習は、地球の幾何学だけでなく、政治的決定の影響を受けます。 1900年代には、世界中のタイムゾーンがある程度標準化されましたが、特に夏時間ルールに関して、恣意的な変更が発生する傾向があります。 PostgreSQLは、広く使用されているIANA (Olson) タイムゾーンデータベースを使用して、タイムゾーンの履歴ルールに関する情報を取得します。 将来の時間については、所与の時間帯についての最新の既知のルールは、はるか未来まで無期限に観察され続けるであろうという仮定がある。

PostgreSQLは、一般的な使用法のSQL標準定義と互換性があるように努めています。 ただし、SQL標準には、日付と時刻のタイプと機能の奇妙な組み合わせがあります。 2つの明らかな問題は次のとおりです。

• dateタイプにタイムゾーンを関連付けることはできませんが、timeタイプに関連付けることはできます。 現実世界のタイムゾーンは、日付と時間に関連付けられていない限りほとんど意味がありません。これは、夏時間の境界でオフセットが年を通じて変化する可能性があるためです。

• デフォルトのタイムゾーンは、UTCからの一定の数値オフセットとして指定されます。 したがって、DST境界を越えて日付 /時刻演算を行う場合、夏時間に適応することは不可能である。

これらの問題に対処するため、タイムゾーンを使用する場合は、日付と時刻の両方を含む日付 /時刻タイプを使用することをお勧めします。 タイプtime withタイムゾーンの使用は推奨しません (ただし、レガシーアプリケーションおよびSQL標準への準拠のためにPostgreSQLでサポートされています) 。 PostgreSQLは、日付または時刻のみを含む任意のタイプのローカルタイムゾーンを想定しています。

すべてのタイムゾーン対応の日付と時刻は、UTCに内部的に格納されます。 これらは、クライアントに表示される前に、TimeZone設定パラメーターで指定されたゾーンのローカル時間に変換されます。

PostgreSQLallowesタイムゾーンを3つの異なる形式で指定できます。

• フルタイムゾーン名 (America/New_Yorkなど) 。 認識されたタイムゾーン名は、pg_timezone_namesビューに一覧表示されます。 PostgreSQLはこの目的で広く使用されているIANAタイムゾーンデータを使用するため、同じタイムゾーン名が他のソフトウェアによっても認識されます。

• タイムゾーンの省略形 (PSTなど) 。 このような仕様は、単にUTCからの特定のオフセットを定義します。これは、夏時間の移行ルールのセットを暗示する可能性のあるフルタイムゾーン名とは対照的です。 認識された略語は、pg_timezone_abbrevsビューに一覧表示されます。 設定パラメーターTimeZoneまたはlog_timezoneをタイムゾーンの省略形に設定することはできませんが、日付 /時刻入力値およびATTIME zone演算子で省略形を使用できます。

• タイムゾーン名と略語に加えて、PostgreSQLはPOSIXスタイルのタイムゾーン仕様を受け入れます。 このオプションは通常、名前付きタイムゾーンを使用する場合には適していませんが、適切なIANAタイムゾーンエントリがない場合は必要になる場合があります。

要するに、これは略語とフルネームの違いです。略語は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は、ある年にはUTC3、他の年にはUTC4を意味しています。 PostgreSQLは、指定された日付に意味する (または最近意味した) ものに従ってそのような略語を解釈します。ただし、上記のESTの例と同様に、これは必ずしもその日付の現地市民時間と同じではありません。

すべての場合において、タイムゾーン名と略語はケースセンシティブに認識されます。 (これは、8.2前のPostgreSQLバージョンからの変更であり、一部のコンテキストでは大文字と小文字が区別されますが、他のコンテキストでは区別されませんでした。)

タイムゾーン名も略語もサーバーにハードワイヤードされていません。. ../share/timezone /と. ../share/timezonesets /インストールディレクトリの

TimeZone設定パラメーターは、ファイルpostgresql.confまたはその他の標準的な方法で設定できます。 それを設定するいくつかの特別な方法もあります:

• SET TIME ZONEは、セッションのタイムゾーンを設定します。 これは、SET TIMEZONE TOの代替スペルであり、SQL仕様と互換性のある構文を使用しています。

• PGTZ環境変数は、接続時にサーバーにSET TIME ZONEコマンドを送信するためにbylibpqclientsで使用されます。

インターバル入力

interval値は、次の冗長構文を使用して記述できます。

[@] 数量単位 [数量単位...] [方向]

単位は、マイクロ秒、ミリ秒、秒、分、時間、日、週、月、年、10年、世紀、ミレニアム、またはこれらの単位の略語または複数です。directionは前または空にすることができます。 at記号 (@) はオプションのノイズです。 異なる単位の量は、適切な符号計算で暗黙的に加算される。前にすべてのフィールドを無効にします。 この構文は、IntervalStyleがpostgres_verboseに設定されている場合、間隔出力にも使用されます。

日、時間、分、秒の量は、明示的な単位マーキングなしで指定できます。 例えば、「1 12:59:10」は、「1日12時間59分10秒」と同じように読まれる。 また、年と月の組み合わせをダッシュで指定することもできます。たとえば、「200-10」は「200年10月」と同じように読み取られます。 (これらの短い形式は、実際にはSQLstandardで許可されている唯一の形式であり、IntervalStyleがsql_standardに設定されている場合に出力に使用されます。)

間隔値は、標準のセクション4.4.3.2の「指定子付きフォーマット」またはセクション4.4.3.3の「代替フォーマット」のいずれかを使用して、ISO 8601時間間隔として記述することもできます。 指定子付きの形式は次のようになります。

P数量単位 [数量単位...] [T [数量単位...]]

文字列はPで始まる必要があり、時刻単位を導入するTを含むことができます。 単位は省略でき、任意の順序で指定できますが、1日未満の単位はTの後に表示する必要があります。 特に、Mの意味は、それがTの前か後かに依存する。

ISO 8601インターバル単位の略語

代替フォーマットでは:

P [年-月-日] [ T時間: 分: 秒]

文字列はPで始まる必要があり、Tは間隔の日付と時間の部分を区切ります。 値は、ISO 8601の日付と同様の数字として与えられる。

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

SQLstandardによると、間隔値のすべてのフィールドは同じ符号を持つ必要があるため、先行する負の符号がすべてのフィールドに適用されます。たとえば、間隔リテラル '-1 2:03:04' の負の符号は、日と時間 /分 /秒の両方の部分に適用されます。この例では、時間 /分 /秒の部分は正と見なされます。 IntervalStyleがsql_standardに設定されている場合、先頭記号はすべてのフィールドに適用されると見なされます (ただし、追加の記号が表示されない場合のみ) 。 さもなければ、traditionalPostgreSQLinterpretationが使用される。 あいまいさを避けるために、フィールドが負の場合は、各フィールドに明示的な記号を付けることをお勧めします。

フィールド値は、小数部を有することができる: 例えば、「1.5週間」または「01:02:03.45」。 ただし、間隔は内部で3つの整数単位 (月、日、マイクロ秒) しか格納しないため、小数単位をより小さな単位にスピルする必要があります。 月を超える単位の部分は、月の整数になるように切り捨てられ、例えば、「1.5年」は、「1年6月」になる。 週および日の分数部分は、1ヶ月あたり30日および1日あたり24時間を仮定して、整数の日数およびマイクロ秒であるように計算され、例えば、「1.75ヶ月」は、1月22日12:00:00になる。 秒のみが出力に分数として表示されます。

インターバル入力

内部間隔の値は、月、日、マイクロ秒として格納されます。 これは、月の日数が変化するために行われ、夏時間の調整が含まれる場合、1日は23時間または25時間になる可能性があります。 月および日フィールドは整数であり、マイクロ秒フィールドは分数秒を格納することができる。 通常、間隔は定数文字列またはタイムスタンプの減算から作成されるため、この格納方法はほとんどの場合うまく機能しますが、予期しない結果を引き起こす可能性があります。

SELECT EXTRACT (80分からの時間:: 間隔);
     date_part
    -----------
             1

    SELECT EXTRACT (「80時間」からの日数:: 間隔);
     date_part
    -----------
             0 

関数justify_daysとjustify_hoursは、通常の範囲をオーバーフローする日と時間を調整するために使用できます。

インターバル出力

interval型の出力形式は、コマンドset intervalstyleを使用して、4つのスタイルsql_standard、postgres、postgres_verbose、またはiso_8601のいずれかに設定できます。 デフォルトはpostgres形式です。

sql_standardスタイルは、インターバル値が標準の制限 (年月のみまたは日時のみ、正と負のコンポーネントの混合なし) を満たしている場合、SQL標準のインターバルリテラル文字列の仕様に準拠した出力を生成します。 それ以外の場合、出力は、標準的な年-月のリテラル文字列の後に日時のリテラル文字列が続くように見え、混合記号間隔の曖昧さを解消するために明示的な記号が追加されます。

インターバル出力スタイルの例