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

MONTH

Описание​

Функция MONTH извлекает номер месяца из значения даты и времени. Возвращаемое значение находится в диапазоне от 1 до 12, что соответствует 12 месяцам года. Функция поддерживает обработку типов DATE и DATETIME.

Поведение этой функции соответствует функции month в MySQL при использовании MONTH в качестве единицы измерения.

Синтаксис​

MONTH(`<date_or_time_expr>`)

Параметры​

ПараметрОписание
<date_or_time_expr>Входное значение даты и времени. Поддерживаются типы date/datetime. Подробнее о форматах даты и времени и форматах даты см. в разделах преобразование даты и времени и преобразование даты.

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

Возвращает значение типа TINYINT, обозначающее номер месяца:

  • Диапазон: от 1 до 12
  • 1 соответствует январю, 12 соответствует декабрю
  • Если входное значение равно NULL, возвращает NULL

Примеры​

-- Extract month from DATE type
SELECT MONTH('1987-01-01') AS result;
+--------+
| result |
+--------+
|      1 |
+--------+

-- Extract month from DATETIME type
SELECT MONTH('2023-07-13 22:28:18') AS result;
+--------+
| result |
+--------+
|      7 |
+--------+

-- Extract month from DATETIME with fractional seconds
SELECT MONTH('2023-12-05 10:15:30.456789') AS result;
+--------+
| result |
+--------+
|     12 |
+--------+

-- Returns NULL when input is NULL
SELECT MONTH(NULL) AS result;
+--------+
| result |
+--------+
| NULL   |
+--------+
Report issue