メインコンテンツまでスキップ

MILLISECONDS_DIFF

説明

2つのdatetime値の間のミリ秒差を計算します。結果は<end_date>から<start_date>を減算したミリ秒数です。

構文

MILLISECONDS_DIFF(<enddate>, <startdate>)

パラメータ

パラメータ説明
<end_date>終了時刻、DATETIMEV2型
<start_date>開始時刻、DATETIMEV2型

戻り値

2つの時刻の間のミリ秒の差を表すINT型を返します。

  • <end_date><start_date>より大きい場合、正の数を返します。
  • <end_date><start_date>より小さい場合、負の数を返します。
  • 1秒 = 1,000ミリ秒。
  • 1ミリ秒 = 1,000マイクロ秒。

SELECT MILLISECONDS_DIFF('2020-12-25 21:00:00.623000', '2020-12-25 21:00:00.123000');
+-----------------------------------------------------------------------------------------------------------------------------+
| milliseconds_diff(cast('2020-12-25 21:00:00.623000' as DATETIMEV2(3)), cast('2020-12-25 21:00:00.123000' as DATETIMEV2(3))) |
+-----------------------------------------------------------------------------------------------------------------------------+
| 500 |
+-----------------------------------------------------------------------------------------------------------------------------+

注記:

  • 例における時間差は0.5秒で、これは500ミリ秒に相当します。
  • 関数の結果は入力時間の精度に依存します。例では小数点以下3桁の精度を使用しています。
  • 結果はミリ秒の差のみを返し、マイクロ秒部分は含まれません。