AT TIME ZONE 関数
AT TIME ZONE は、TIMESTAMP 式または TIMESTAMPTZ 式で使用するタイムゾーンを指定します。
構文
AT TIME ZONE 'timezone'
引数
- timezone
-
戻り値の
TIMEZONE。タイムゾーンは、タイムゾーン名 ('Africa/Kampala'または'Singapore'など) またはタイムゾーンの略名 ('UTC'または'PDT'など) として指定できます。サポートされるタイムゾーン名のリストを表示するには、次のコマンドを実行します。
select pg_timezone_names();サポートされるタイムゾーン省略形のリストを表示するには、次のコマンドを実行します。
select pg_timezone_abbrevs();詳細な説明と例については、「タイムゾーンの使用上の注意」を参照してください。
戻り型
TIMESTAMP 式で使用する場合は TIMESTAMPTZ。TIMESTAMPTZ 式で使用する場合は TIMESTAMP。
例
次の例では、タイムゾーンのないタイムゾーン値を変換して MST 時間 (POSIX では UTC+7) として解釈します。この例では、UTC タイムゾーンのデータ型 TIMESTAMPTZ の値を返します。デフォルトのタイムゾーンを UTC 以外のタイムゾーンに設定すると、異なる結果が表示される場合があります。
SELECT TIMESTAMP '2001-02-16 20:38:40' AT TIME ZONE 'MST';
timezone
------------------------
2001-02-17 03:38:40+00次の例では、指定されたタイムゾーンが EST (POSIX では UTC+5) であるタイムゾーン値を持つ入力タイムスタンプを取得し、それを MST (POSIX では UTC+7) に変換します。この例では、データ型 TIMESTAMP の値を返します。
SELECT TIMESTAMPTZ '2001-02-16 20:38:40-05' AT TIME ZONE 'MST';
timezone
------------------------
2001-02-16 18:38:40