SEC_TO_TIME

説明

SEC_TO_TIME関数は、秒単位の数値をTIME型に変換します。戻り値の形式はHH:MM:SSまたはHH:MM:SS.ssssssです。入力される秒数は、1日の開始点（00:00:00.000000）から計算された時間を表し、正の秒数と負の秒数、および1日を超える時間範囲をサポートします。

この関数は、MySQLのsec_to_time関数と一致しています。

構文

SEC_TO_TIME(<seconds>)

パラメータ

パラメータ	説明
<seconds>	必須。入力する秒数。1日の開始時刻（00:00:00）からの計算された秒数を表す。正または負の整数型をサポート。

戻り値

秒数からTIME型の値に変換して返す。

• 入力秒数がTIME型の有効範囲（-838:59:59から838:59:59、対応する秒数の範囲は-3023999から3023999）を超える場合、TIME型の最大値または最小値を返す
• 入力がNULLの場合、NULLを返す
• 入力が整数の場合、戻り値の形式はHH:MM:SS。入力が浮動小数点数の場合、戻り値の形式はHH:MM:SS.ssssss。

例

-- Positive seconds (time within the day)
SELECT SEC_TO_TIME(59738) AS result;
+----------+
| result   |
+----------+
| 16:35:38 |
+----------+

-- Seconds exceeding one day (automatically converted to multiple hours)
SELECT SEC_TO_TIME(90061) AS result;
+----------+
| result   |
+----------+
| 25:01:01 |
+----------+

-- Negative seconds (time from previous day)
SELECT SEC_TO_TIME(-3600) AS result;
+----------+
| result   |
+----------+
| -01:00:00 |
+----------+

-- Zero seconds (start time)
SELECT SEC_TO_TIME(0) AS result;
+----------+
| result   |
+----------+
| 00:00:00 |
+----------+

-- Decimal seconds
SELECT SEC_TO_TIME(3661.9) AS result;
+-----------------+
| result          |
+-----------------+
| 01:01:01.900000 |
+-----------------+

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

--- If the input seconds exceed the valid range of TIME type (-838:59:59 to 838:59:59, corresponding to seconds range -3023999 to 3023999), returns TIME max or min value
 SELECT SEC_TO_TIME(30245000) AS result;
+-----------+
| result    |
+-----------+
| 838:59:59 |
+-----------+

SELECT SEC_TO_TIME(-30245000) AS result;
+------------+
| result     |
+------------+
| -838:59:59 |
+------------+