DATEDIFF 関数

DATEDIFF は 2 つの日付または時刻式の日付部分の差を返します。

構文

DATEDIFF( datepart, {date|time|timetz|timestamp}, {date|time|timetz|timestamp} )

引数

datepart

関数が実行される日付または時刻値 (年、月、または日、時、分、秒、ミリ秒、またはマイクロ秒) の特定部分。詳細については、「日付関数またはタイムスタンプ関数の日付部分」を参照してください。

特に、DATEDIFF は 2 つの式の間で越える日付部分の境界の数を決定します。例えば、12-31-2008 と 01-01-2009 の 2 つの日付間で年の差を計算しているとします。この場合、これらの日付は 1 日しか離れていないにもかかわらず、関数は 1 年を返します。2 つのタイムスタンプ (01-01-2009 8:30:00 と 01-01-2009 10:00:00) の間で時間の差が分かっている場合、結果は 2 時間になります。2 つのタイムスタンプ (8:30:00 と 10:00:00) の間で時間の差が分かっている場合、結果は 2 時間になります。

date|time|timetz|timestamp

DATE、TIME、TIMETZ、または TIMESTAMP の列、あるいは暗黙的に DATE、TIME、TIMETZ、または TIMESTAMP に変換される式。両方の式には、指定した日付部分または時刻部分を含める必要があります。2 番目の日付または時刻が 1 番目の日付または時刻よりも後である場合、結果は正です。2 番目の日付または時刻が 1 番目の日付または時刻よりも前である場合、結果は負です。

戻り型

BIGINT

DATE 列の例

次の例では、2 つの日付リテラル値の間の差 (週単位) を取得します。

select datediff(week,'2009-01-01','2009-12-31') as numweeks;

numweeks
----------
52
(1 row)

次の例は、2 つの日付リテラル値の差 (時間単位) を検出します。日付の時刻値を指定しなかった場合、デフォルトで 00:00:00 に設定されます。

select datediff(hour, '2023-01-01', '2023-01-03 05:04:03');
            
date_diff
----------
53
(1 row)

次の例は、2 つの日付リテラル TIMESTAMETZ 値の差 (日単位) を検出します。

Select datediff(days, 'Jun 1,2008  09:59:59 EST', 'Jul 4,2008  09:59:59 EST')
         
date_diff
----------
33

次の例は、テーブルの同じ行の 2 つの日付の差 (日単位) を検出します。

select * from date_table;

start_date |   end_date
-----------+-----------
2009-01-01 | 2009-03-23
2023-01-04 | 2024-05-04
(2 rows)

select datediff(day, start_date, end_date) as duration from date_table;
         
duration
---------
      81
     486
(2 rows)

次の例では、過去のリテラル値と今日の日付の間の差 (四半期単位) を取得します。この例では、現在の日付を 2008 年 6 月 5 日とします。完全名または略名で日付部分に名前を付けることができます。DATEDIFF 関数のデフォルトの列名は DATE_DIFF です。

select datediff(qtr, '1998-07-01', current_date);

date_diff
-----------
40
(1 row)

次の例では、SALES テーブルと LISTING テーブルを結合し、リスト 1000 から 1005 に対してチケットをリストしてから何日後に販売されたかを計算します。これらのリストの販売を最長の待機期間は 15 日であり、最小は 1 日より短いです (0 日)。

select priceperticket,
datediff(day, listtime, saletime) as wait
from sales, listing where sales.listid = listing.listid
and sales.listid between 1000 and 1005
order by wait desc, priceperticket desc;

priceperticket | wait
---------------+------
 96.00         |   15
 123.00        |   11
 131.00        |    9
 123.00        |    6
 129.00        |    4
 96.00         |    4
 96.00         |    0
(7 rows)

この例は、販売者が任意およびすべてのチケット販売を待機する平均時間を計算します。

select avg(datediff(hours, listtime, saletime)) as avgwait
from sales, listing
where sales.listid = listing.listid;

avgwait
---------
465
(1 row)

TIME 列の例

次のテーブルの TIME_TEST の例には、3 つの値が挿入された列 TIME_VAL (タイプ TIME) があります。

select time_val from time_test;
            
time_val
---------------------
20:00:00
00:00:00.5550
00:58:00

次の例では、TIME_VAL 列と時刻リテラル間の時間数の差を検出します。

select datediff(hour, time_val, time '15:24:45') from time_test;
         
 date_diff
-----------
        -5
        15
        15

次の例では、2 つのリテラル時間値の分数の差を検出します。

select datediff(minute, time '20:00:00', time '21:00:00') as nummins;  
         
nummins 
---------- 
60

TIMETZ 列の例

次のテーブルの TIMETZ_TEST の例には、3 つの値が挿入された列 TIMETZ_VAL (タイプ TIMETZ) があります。

select timetz_val from timetz_test;
            
timetz_val
------------------
04:00:00+00
00:00:00.5550+00
05:58:00+00

次の例では、TIMETZ リテラルと timetz_val の間の時間数の差を検出します。

select datediff(hours, timetz '20:00:00 PST', timetz_val) as numhours from timetz_test;

numhours 
---------- 
0
-4
1

次の例では、2 つのリテラル TIMETZ 値間の時間数の差を検出します。

select datediff(hours, timetz '20:00:00 PST', timetz '00:58:00 EST') as numhours;
         
numhours 
---------- 
1