Перейти к содержимому
Последнее обновление

MINUTE

Описание​

Функция MINUTE извлекает значение минут из входного значения даты и времени и возвращает целое число в диапазоне от 0 до 59. Функция поддерживает обработку типов DATE, DATETIME и TIME.

Эта функция соответствует функции minute в MySQL.

Синтаксис​

MINUTE(`<date_or_time_expr>`)

Параметры​

ПараметрОписание
<date_or_time_expr>Входное значение даты и времени, которое может иметь тип DATE, DATETIME или TIME. Подробнее о форматах даты и времени, даты и времени по отдельности см. в разделах Преобразование даты и времени, Преобразование даты и Преобразование времени.

Возвращаемое значение​

Возвращает целое число типа INT, представляющее значение минут из входного значения даты и времени, в диапазоне 0-59.

  • Если входное значение имеет тип 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 |
+--------+
Report issue