カテゴリ:

日付と時刻の関数

TIMEDIFF

指定された日付または時刻の部分に基づいて、2つの日付、時刻、またはタイムスタンプ式の差を計算します。

DATEDIFF の代替です。

構文

TIMEDIFF( <date_or_time_part> , <date_or_time_expr1> , <date_or time_expr2> )

引数

  • 日付または時刻部分 は、 サポートされている日付と時刻の部分 にリストされている値のいずれかでなければなりません。

  • 日付または時刻式1日付または時刻式2 は、日付、時刻、タイムスタンプであるか、それらのいずれかを評価できる式でなければなりません。最初の値が2番目の値から減算されます。

使用上の注意

  • その他の使用上の注意については、 DATEDIFF引数 をご参照ください。

これは、2つの日付を減算した結果を示しており、2番目の日付は最初の日付から2年後のものです。

SELECT TIMEDIFF(YEAR, '2017-01-01', '2019-01-01') AS Years;
+-------+
| YEARS |
|-------|
|     2 |
+-------+

これは、値が丸められるのではなく切り捨てられることを示しています。差は11か月よりも12か月に近いですが、Snowflakeは差を11か月として計算します。

SELECT TIMEDIFF(MONTH, '2017-01-1', '2017-12-31') AS Months;
+--------+
| MONTHS |
|--------|
|     11 |
+--------+

DATEDIFF には追加の例があります。

最上部に戻る