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

SECONDS_ADD

説明​

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

構文​

SECONDS_ADD(<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_ADD('2025-01-23 12:34:56', 30),SECONDS_ADD('2025-01-23 12:34:56', -30);
+---------------------------------------------------------------+----------------------------------------------------------------+
| seconds_add(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 30) | seconds_add(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), -30) |
+---------------------------------------------------------------+----------------------------------------------------------------+
| 2025-01-23 12:35:26                                           | 2025-01-23 12:34:26                                            |
+---------------------------------------------------------------+----------------------------------------------------------------+