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

SECOND_CEIL

デスクリプション​

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

Syntax​

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                                                                                         |
+-------------------------------------------------------------------------------------------------------------+