MINUTE

説明

MINUTE 関数は、入力された日時値から分の部分を抽出し、0 から 59 までの整数を返します。この関数は、DATE、DATETIME、TIMESTAMP_NS、TIME 型を処理できます。

この関数は MySQL の MINUTE 関数 と同じ動作をします。

構文

MINUTE(`<date_or_time_expr>`)

パラメータ

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

戻り値

入力された日時値の分を表す、0 から 59 までの INT 型の整数を返します。

• 入力が DATE 型の場合、時刻部分を含まないため、既定の時刻部分は 00:00:00 となり、0 を返します。
• 入力が NULL の場合、NULL を返します。

例

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

-- Extract minute from DATETIME with microseconds (ignores microseconds)
SELECT MINUTE('2023-05-01 10:05:30.123456') AS result;
+--------+
| result |
+--------+
|      5 |
+--------+

SELECT MINUTE('14:25:45') AS result;
+--------+
| result |
+--------+
|     25 |
+--------+

-- Extract minute from DATE type (default time 00:00:00)
SELECT MINUTE('2023-07-13') AS result;
+--------+
| result |
+--------+
|      0 |
+--------+

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