TIMESTAMPTZ_CMP_DATE 関数 - Amazon Redshift
構文引数戻り型例

TIMESTAMPTZ_CMP_DATE 関数

TIMESTAMPTZ_CMP_DATE は、タイムスタンプの値と日付を比較します。タイムスタンプと日付の値が同じである場合、関数は 0 を返します。タイムスタンプが時間的により大きい場合、関数は 1 を返します。日付がより大きい場合、関数は –1 を返します。

構文

TIMESTAMPTZ_CMP_DATE(timestamptz, date)

引数

timestamptz

データ型 TIMESTAMPTZ の列または TIMESTAMPTZ 型に暗黙的に評価される式。

date

データ型 DATE の列または DATE 型に暗黙的に評価される式。

戻り型

INTEGER

例

次の例では、LISTTIME (タイムゾーン付きのタイムスタンプ) と日付 2008-06-18 を比較します。この日付より後に作成されたリストは 1 を返し、この日付より前に作成されたリストは -1 を返します。

select listid, CAST(listtime as timestamptz) as tstz,
timestamp_cmp_date(tstz, '2008-06-18')
from listing
order by 1, 2, 3
limit 10;


 listid |          tstz          | timestamptz_cmp_date
--------+------------------------+----------------------
      1 | 2008-01-24 06:43:29+00 |              -1
      2 | 2008-03-05 12:25:29+00 |              -1
      3 | 2008-11-01 07:35:33+00 |               1
      4 | 2008-05-24 01:18:37+00 |              -1
      5 | 2008-05-17 02:29:11+00 |              -1
      6 | 2008-08-15 02:08:13+00 |               1
      7 | 2008-11-15 09:38:15+00 |               1
      8 | 2008-11-09 05:07:30+00 |               1
      9 | 2008-09-09 08:03:36+00 |               1
     10 | 2008-06-17 09:44:54+00 |              -1
(10 rows)