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

SECOND_CEIL

説明​

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

構文​

SECOND_CEIL(<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_CEIL('2025-01-23 12:34:56');
+-----------------------------------------------------------+
| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0))) |
+-----------------------------------------------------------+
| 2025-01-23 12:34:56                                       |
+-----------------------------------------------------------+

<datetime> と <origin_datetime> の指定

SELECT SECOND_CEIL('2025-01-23 12:34:56', '2025-01-01 00:00:00');
+---------------------------------------------------------------------------------------------------------+
| second_ceil(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_CEIL('2025-01-23 12:34:56', 5)
+--------------------------------------------------------------+
| second_ceil(cast('2025-01-23 12:34:56' as DATETIMEV2(0)), 5) |
+--------------------------------------------------------------+
| 2025-01-23 12:35:00                                          |
+--------------------------------------------------------------+

<datetime>、<period>、<origin_datetime>の指定

SELECT SECOND_CEIL('2025-01-23 12:34:56', 10, '2025-01-23 12:00:00');
+-------------------------------------------------------------------------------------------------------------+
| second_ceil(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:35:00                                                                                         |
+-------------------------------------------------------------------------------------------------------------+