Hitachi

Hitachi Advanced Data Binder SQLリファレンス


8.9.1 DATEDIFF

開始日時と終了日時の差を返します。

メモ

スカラ関数DATEDIFFとスカラ関数TIMESTAMPDIFFに機能差はありません。

〈この項の構成〉

(1) 指定形式

スカラ関数DATEDIFF::=DATEDIFF(日時単位,開始日時,終了日時)
 
  日時単位::={YEAR|QUARTER|MONTH|WEEK|DAY
                |DAYOFYEAR|HOUR|MINUTE|SECOND
                |MILLISECOND|MICROSECOND|NANOSECOND|PICOSECOND}
  開始日時::=値式
  終了日時::=値式

(2) 指定形式の説明

日時単位

開始日時終了日時の差を求めるときの単位を指定します。次に示すどれかの値を指定してください。

  • YEAR

    開始日時終了日時の差を年単位で求める場合に指定します。

    (例)

    DATEDIFF(YEAR,'2011-05-05','2013-07-10') → 2

    DATEDIFF(YEAR,'2013-05-05','2013-07-10') → 0

    DATEDIFF(YEAR,'2012-12-31 23:59:59','2013-01-01 00:00:00') → 1

  • QUARTER

    開始日時終了日時の差を四半期単位で求める場合に指定します。1月1日を基準に,3か月単位に分けた範囲で計算します。

    ・第1四半期:01月01日〜03月31日

    ・第2四半期:04月01日〜06月30日

    ・第3四半期:07月01日〜09月30日

    ・第4四半期:10月01日〜12月31日

    (例)

    DATEDIFF(QUARTER,'2013-01-05','2013-07-10') → 2

    DATEDIFF(QUARTER,'2013-01-05','2013-03-10') → 0

    DATEDIFF(QUARTER,'2012-12-31 23:59:59','2013-01-01 00:00:00') → 1

  • MONTH

    開始日時終了日時の差を月単位で求める場合に指定します。

    (例)

    DATEDIFF(MONTH,'2013-01-05','2013-07-10') → 6

    DATEDIFF(MONTH,'2013-01-05','2013-01-10') → 0

    DATEDIFF(MONTH,'2012-12-31 23:59:59','2013-01-01 00:00:00') → 1

  • WEEK

    開始日時終了日時の差を週単位で求める場合に指定します。週の最初を日曜日として計算します。

    (例)

    DATEDIFF(WEEK,'2013-07-05','2013-07-10') → 1

    2013年7月7日が日曜日で週が変わっているため,1が返ります。

    DATEDIFF(WEEK,'2012-12-30','2013-01-01') → 0

    2012年12月30日が日曜日で週が変わっていないため,0が返ります。

  • DAY

    開始日時終了日時の差を日単位で求める場合に指定します。

    (例)

    DATEDIFF(DAY,'2013-07-05','2013-07-10') → 5

    DATEDIFF(DAY,'2013-07-05 08:02:25','2013-07-05 17:55:18') → 0

    DATEDIFF(DAY,'2012-12-31 23:59:59','2013-01-01 00:00:00') → 1

  • DAYOFYEAR

    開始日時終了日時の差を通算日単位で求める場合に指定します。DAYを指定した場合と同じ結果が返ります。

    (例)

    DATEDIFF(DAYOFYEAR,'2013-07-05','2013-07-10') → 5

    DATEDIFF(DAYOFYEAR,'2013-07-05 08:02:25','2013-07-05 17:55:18') → 0

    DATEDIFF(DAYOFYEAR,'2012-12-31 23:59:59','2013-01-01 00:00:00') → 1

  • HOUR

    開始日時終了日時の差を時単位で求める場合に指定します。

    (例)

    DATEDIFF(HOUR,'2013-07-10 08:02:25','2013-07-10 11:37:55') → 3

    DATEDIFF(HOUR,'2013-07-10 08:02:25','2013-07-10 08:45:15') → 0

    DATEDIFF(HOUR,'2012-12-31 23:59:59','2013-01-01 00:00:00') → 1

  • MINUTE

    開始日時終了日時の差を分単位で求める場合に指定します。

    (例)

    DATEDIFF(MINUTE,'2013-07-10 08:02:25','2013-07-10 08:07:25') → 5

    DATEDIFF(MINUTE,'2013-07-10 08:02:25','2013-07-10 08:02:32') → 0

    DATEDIFF(MINUTE,'2012-12-31 23:59:59','2013-01-01 00:00:00') → 1

  • SECOND

    開始日時終了日時の差を秒単位で求める場合に指定します。

    (例)

    DATEDIFF(SECOND,'2013-07-10 08:02:25','2013-07-10 08:02:33') → 8

    DATEDIFF(SECOND,'2012-12-31 23:59:59','2013-01-01 00:00:00') → 1

  • MILLISECOND

    開始日時終了日時の差をミリ秒(1/1,000秒)単位で求める場合に指定します。

    (例)

    DATEDIFF(MILLISECOND,'08:02:25.000','08:02:25.003') → 3

    DATEDIFF(MILLISECOND,'08:02:24.000','08:02:25.001') → 1001

    DATEDIFF(MILLISECOND,'08:02:25.000000','08:02:25.003111') → 3

  • MICROSECOND

    開始日時終了日時の差をマイクロ秒(1/1,000,000秒)単位で求める場合に指定します。

    (例)

    DATEDIFF(MICROSECOND,'08:02:25.000000','08:02:25.000012') → 12

  • NANOSECOND

    開始日時終了日時の差をナノ秒(1/1,000,000,000秒)単位で求める場合に指定します。

    (例)

    DATEDIFF(NANOSECOND,'08:02:25.000000000','08:02:25.000000123') → 123

  • PICOSECOND

    開始日時終了日時の差をピコ秒(1/1,000,000,000,000秒)単位で求める場合に指定します。

    (例)

    DATEDIFF(PICOSECOND,'08:02:25.000000000000','08:02:25.000000000003') → 3

開始日時

開始日時を指定します。

指定規則を次に示します。

  • 開始日時は,値式の形式で指定します。値式については,「7.21 値式」を参照してください。

  • 開始日時のデータ型は,DATE型,TIME型,TIMESTAMP型,CHAR型,またはVARCHAR型のどれかにしてください。ただし,CHAR型またはVARCHAR型の場合は,既定の入力表現の形式に従っている文字列定数だけを指定できます。既定の入力表現については,「6.3.3 既定の文字列表現」を参照してください。

  • 開始日時には,?パラメタを単独で指定できません。

終了日時

終了日時を指定します。

指定規則を次に示します。

  • 終了日時は,値式の形式で指定します。値式については,「7.21 値式」を参照してください。

  • 終了日時のデータ型は,DATE型,TIME型,TIMESTAMP型,CHAR型,またはVARCHAR型のどれかにしてください。ただし,CHAR型またはVARCHAR型の場合は,既定の入力表現の形式に従っている文字列定数だけを指定できます。既定の入力表現については,「6.3.3 既定の文字列表現」を参照してください。

  • 終了日時には,?パラメタを単独で指定できません。

(3) 規則

  1. 実行結果には,終了日時から開始日時を減算した値を返します。終了日時開始日時よりも前の日時の場合は,負の値を返します。

  2. 開始日時のデータ型がDATE型で,終了日時のデータ型がTIMESTAMP型のように,片方の日時に時,分,秒の要素がない場合,時,分,秒には00:00:00が仮定されます。小数秒の桁数が不足している場合は,不足しているすべての桁に0が仮定されます。

    (例)DATEDIFF(SECOND,'2013-07-10','2013-07-10 00:00:07') → 7

    上記の例の場合,開始日時には'2013-07-10 00:00:00'が仮定されます。

  3. 開始日時DATE型,TIMESTAMP型,日付を表す既定の文字列表現,または時刻印を表す既定の文字列表現を指定した場合,終了日時にもDATE型,TIMESTAMP型,日付を表す既定の文字列表現,または時刻印を表す既定の文字列表現を指定してください。

  4. 開始日時TIME型,または時刻を表す既定の文字列表現を指定した場合,終了日時にもTIME型,または時刻を表す既定の文字列表現を指定してください。

  5. 開始日時および終了日時に,TIME型または時刻を表す既定の文字列表現を指定し,かつ日時単位YEARQUARTERMONTHDAYOFYEARDAY,またはWEEKを指定した場合,実行結果の値は0になります。

  6. 実行結果のデータ型はINTEGER型になります。実行結果の値がINTEGER型で表せる範囲を超えた場合,エラーになります。INTEGER型で表せる範囲については,「6.2.1 データ型の種類」の「(1) 数データ」を参照してください。

  7. 実行結果の値は,非ナル値制約なし(ナル値を許す)となります。

  8. 開始日時または終了日時がナル値の場合,実行結果はナル値になります。

(4) 例題

例題

T1C1列とC2列の日時データの差を,日単位で求めます。

SELECT DATEDIFF(DAY,"C1","C2") FROM "T1"

[図データ]