DATEDIFF 函數

DATEDIFF 傳回兩個日期或時間表達式之日期部分的差異。

Syntax (語法)

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

引數

datepart

函數對其執行的日期或時間值特定部分 (年、月或日、小時、分、秒、毫秒或微秒)。如需詳細資訊，請參閱 日期或時間戳函數的日期部分。

特別是，DATEDIFF 會決定兩個表達式間相距的日期部分邊界數。例如，假設您正在計算兩個日期間年份的差異，12-31-2008和01-01-2009。在這種情況下，函數會傳回 1 年，儘管這兩個日期間僅差距一天。如果您正在尋找兩個時間戳記間時數的差異，01-01-2009 8:30:00和01-01-2009 10:00:00，則結果為 2 小時。如果您正在尋找兩個時間戳記間時數的差異，8:30:00和10:00:00，則結果為 2 小時。

日期|時間|時間|時間戳

日期、時間、TIMTZ 或時間戳列或隱式轉換為日期、時間、時間或時間戳的表達式。表達式必須同時包含指定的日期或時間部分。如果第二個日期或時間晚於第一個日期或時間，結果為正值。如果第二個日期或時間早於第一個日期或時間，結果為負值。

傳回類型

BIGINT

具有 DATE 列的示例

下列範例傳回兩個常值日期值間週次的差異。

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

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

下列範例傳回過去日期和今日日期中常值間季次的差異。此範例假設目前日期為 2008 年 6 月 5 日。您可以用全名或縮寫來表示日期部分。DATEDIFF 函數的預設欄名稱為 DATE_DIFF。

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

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

以下範例會聯結 SALES 和 LISTING 資歷表，來計算在他們列出和門票售出後所經的天數：清單 1000 到 1005。這些清單銷售的最長等待時間是 15 天，而最短時間是不到一天 (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_VAL（類型時間），其中插入了三個值。

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

以下示例查找兩個文字時間值之間的分鐘數差異。

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

具有時間 TEMZ 列的示例

下面的示例表具有一列時間 Z_VAL（類型為時間 TIMEZ），其中插入了三個值。

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

以下示例查找兩個文本 TIMETZ 值之間的小時數差值。

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