メインコンテンツまでスキップ
バージョン: 2.1

MINUTES_DIFF

概要​

2つのdatetime値間の分単位の差を計算します。結果は<end_date>から<start_date>を減算した分数になります。

構文​

MINUTES_DIFF(<enddate>, <startdate>)

パラメータ​

Parameterデスクリプション
<end_date>終了時刻。DATE、DATETIME、またはDATETIMEV2型を指定可能
<start_date>開始時刻。DATE、DATETIME、またはDATETIMEV2型を指定可能

Return Value​

2つの時刻間の分単位の差を表すINT型を返します。

  • <end_date>が<start_date>より大きい場合は正の数を返します。
  • <end_date>が<start_date>より小さい場合は負の数を返します。

Example​

SELECT MINUTES_DIFF('2020-12-25 22:00:00', '2020-12-25 21:00:00');
+----------------------------------------------------------------------------------------------------------+
| minutes_diff(cast('2020-12-25 22:00:00' as DATETIMEV2(0)), cast('2020-12-25 21:00:00' as DATETIMEV2(0))) |
+----------------------------------------------------------------------------------------------------------+
|                                                                                                       60 |
+----------------------------------------------------------------------------------------------------------+

注意：

  • 計算は完全な分のみを考慮し、秒とミリ秒は無視されます。
  • いずれかの入力パラメータがNULLの場合、関数はNULLを返します。
  • 日、月、または年をまたぐ時間差を処理することができます。