TIMEDIFF'('＜time1＞,＜time2＞')'

引数time1とtime2の差分を計算し，結果をミリ秒の数値で返します。

＜time1＞

時刻データを値式で指定します。

＜time2＞

時刻データを値式で指定します。

引数time1，time2を1970年1月1日 00:00:00 GMTからのミリ秒に変換し，「time2−time1＝差分」で計算した値を返します。単位はミリ秒です。

引数のデータ型と戻り値のデータ型の関係を次の表に示します。

時刻関数名	引数	引数のデータ型	戻り値のデータ型
TIMEDIFF	time1	TIME	BIGINT
	time2	TIME

• TIME型は，java.sql.Time型に対応するため，引数の時刻データは1970年1月1日 00:00:00 GMTが基準となります。引数に日付の繰り上がりがある時刻データを指定した場合，結果の差分は繰り上がった日付を含んだミリ秒の数値を返します。
  例えば，time1に「09:00:00」，time2に「33:00:00」を指定した場合，time1は「1970-01-01 09:00:00」，time2は「1970-01-02 09:00:00」となり，time2の日付が繰り上がります。また，戻り値は，86400000となります。下線部が，日付の部分です。
  

入力値によっては，想定しない値が返る場合があります。

例えば，TIME1='00:00:00'（時刻印データで表すと1970-01-01 00:00:00.000），およびBIGINT1=253402236000000をTIME型に変換した値を入力した場合，TIMEDIFF(TIME1,NUMBER_TOTIME(BIGINT1))は，戻り値253402268400000のミリ秒数値を返します。戻り値253402268400000を時刻印データで表すと，'10000-01-01 00:00:00.000'となります。