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

SECOND_FLOOR

デスクリプション​

この関数は、指定された期間に基づいて入力されたdatetime値を最も近い秒境界に向かって上方向に整列し、整列されたdatetime値を返します。

Syntax​

SECOND_FLOOR(<datetime>[, <period>][, <origin_datetime>])

パラメータ​

Parameterデスクリプション
<datetime>必須。入力のdatetime値。DATETIME型をサポートします。
<period>オプション。各期間の秒数を指定します。正の整数（INT）をサポートします。デフォルトは1秒です。
<origin_datetime>オプション。アライメントの開始点。DATETIME型をサポートします。指定されない場合、デフォルトは0001-01-01T00:00:00です。

戻り値​

  • 入力datetimeを指定された秒の境界の最も近い上位値にアライメントしたdatetime値を返します。
  • <datetime>がNULLの場合、関数はNULLを返します。
  • <datetime>が無効な日付（例：0000-00-00T00:00:00）の場合、関数はNULLを返します。

例​

<datetime>のみを指定する場合

SELECT SECOND_FLOOR('2025-01-23 12:34:56');
+------------------------------------------------------------+
| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
+------------------------------------------------------------+
| 2025-01-23 12:34:56                                        |
+------------------------------------------------------------+

<datetime> と <origin_datetime> の指定

SELECT SECOND_FLOOR('2025-01-23 12:34:56', '2025-01-01 00:00:00');
+----------------------------------------------------------------------------------------------------------+
| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), cast('2025-01-01 00:00:00' as DATETIMEV2(0))) |
+----------------------------------------------------------------------------------------------------------+
| 2025-01-23 12:34:56                                                                                      |
+----------------------------------------------------------------------------------------------------------+

<datetime>と<period>の指定

SELECT SECOND_FLOOR('2025-01-23 12:34:56', 5)
+---------------------------------------------------------------+
| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
+---------------------------------------------------------------+
| 2025-01-23 12:34:55                                           |
+---------------------------------------------------------------+

<datetime>、<period>、および<origin_datetime>の指定

SELECT SECOND_FLOOR('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
+--------------------------------------------------------------------------------------------------------------+
| second_floor(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 10, cast('2025-01-23 12:00:00' as DATETIMEV2(0))) |
+--------------------------------------------------------------------------------------------------------------+
| 2025-01-23 12:34:50                                                                                          |
+--------------------------------------------------------------------------------------------------------------+