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

SECONDS_SUB

説明​

この関数は、指定されたdatetime値に対して、指定された秒数を減算または加算し、結果のdatetimeを返します。

構文​

SECONDS_SUB(<datetime>, <seconds>)

パラメータ​

Parameterデスクリプション
<datetime>必須。入力されるdatetime値。DATETIMEとDATEタイプをサポートします。
<seconds>必須。減算または加算する秒数。整数（INT）をサポートします。正の数は秒を加算し、負の数は秒を減算します。

Return Value​

  • 入力<datetime>と同じタイプのdatetime値を返します。
  • <datetime>がNULLの場合、関数はNULLを返します。
  • <datetime>が無効な日付（例：0000-00-00T00:00:00）の場合、関数はNULLを返します。

Examples​

SELECT SECONDS_SUB('2025-01-23 12:34:56', 30),SECONDS_SUB('2025-01-23 12:34:56', -30);
+---------------------------------------------------------------+----------------------------------------------------------------+
| seconds_sub(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 30) | seconds_sub(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), -30) |
+---------------------------------------------------------------+----------------------------------------------------------------+
| 2025-01-23 12:34:26                                           | 2025-01-23 12:35:26                                            |
+---------------------------------------------------------------+----------------------------------------------------------------+