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

FROM_SECOND

説明​

FROM_SECOND関数は、Unixタイムスタンプ（秒単位）をDATETIME型の日時値に変換するために使用されます。Unixタイムスタンプの基準時刻は1970-01-01 00:00:00 UTCであり、この関数は入力された秒数をその基準時刻以降の対応する具体的な日付と時刻に変換します（秒単位まで正確）。

構文​

FROM_SECOND(<unix_timestamp>)

パラメータ​

Parameterデスクリプション
<unix_timestamp>入力するUnixタイムスタンプ。整数型（BIGINT）で、1970-01-01 00:00:00 UTCからの秒数を表す。

Return Value​

  • 入力されたUTCタイムゾーンのunixタイムスタンプを現在のタイムゾーンの時刻に変換した結果を表すDATETIME型の値を返します
  • <unix_timestamp>がNULLの場合、関数はNULLを返します。
  • <unix_timestamp>が有効な範囲を超える場合（結果のdatetimeが9999-12-31 23:59:59を超える場合）、関数はエラーを返します。
  • 負の秒数を入力すると、関数はエラーを返します

Examples​


----Since the current machine is in East 8th timezone, the returned time is 8 hours ahead of UTC
 SELECT FROM_SECOND(0);
+---------------------+
| FROM_SECOND(0)      |
+---------------------+
| 1970-01-01 08:00:00 |
+---------------------+

---Convert 1700000000 seconds to datetime
SELECT FROM_SECOND(1700000000);

+-------------------------+
| from_second(1700000000) |
+-------------------------+
| 2023-11-15 06:13:20     |
+-------------------------+

---Result exceeds maximum date range, returns error
select from_second(999999999999999);
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[INTERNAL_ERROR]The function from_second Argument value is out of DateTime range

---Input parameter is NULL, returns NULL
select from_second(NULL);
+-------------------+
| from_second(NULL) |
+-------------------+
| NULL              |
+-------------------+

--Input parameter is negative, result returns error
 select from_second(-1);
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation from_second of -1 out of range