SECOND

説明

SECOND 関数は、指定された日時値から秒を抽出し、0 から 59 までの整数を返します。DATE 型、DATETIME 型、TIME 型の値に対応しています。

この関数の動作は、MySQL の second 関数 と同じです。

構文

SECOND(<date_or_time_expr>)

パラメータ

パラメータ	説明
<date_or_time_expr>	入力する日時値。DATE 型、DATETIME 型、TIME 型を指定できます。日時、日付、時刻の形式については、日時型の変換、日付型の変換、時刻型の変換を参照してください。

戻り値

入力された日時値の秒を表す INT 型の値を返します。

• 範囲は 0 から 59 までです（両端を含みます）。
• 入力が DATE 型の場合は、時刻部分のデフォルト値が 00:00:00 であるため、0 を返します。
• 入力が NULL の場合は NULL を返します。
• マイクロ秒部分は無視します（例：12:34:56.789 から抽出される秒は 56 です）。

例

-- Extract seconds from DATETIME
SELECT SECOND('2018-12-31 23:59:59') AS result;
+--------+
| result |
+--------+
|     59 |
+--------+

-- Input is TIME type
SELECT SECOND(cast('15:42:33' as time)) AS result;
+--------+
| result |
+--------+
|     33 |
+--------+

-- Input is DATE type (default seconds is 0)
SELECT SECOND('2023-07-13') AS result;
+--------+
| result |
+--------+
|      0 |
+--------+

-- Time with microseconds (ignores microseconds)
SELECT SECOND('2023-07-13 10:30:25.123456') AS result;
+--------+
| result |
+--------+
|     25 |
+--------+

-- Case where seconds is 0
SELECT SECOND('2024-01-01 00:00:00') AS result;
+--------+
| result |
+--------+
|      0 |
+--------+

-- When a string literal is valid for both datetime and time, prefer parsing it as time
SELECT SECOND("22:12:12");
+--------------------+
| SECOND("22:12:12") |
+--------------------+
|                 12 |
+--------------------+

-- Input is NULL (returns NULL)
SELECT SECOND(NULL) AS result;
+--------+
| result |
+--------+
| NULL   |
+--------+