MONTH

설명

MONTH 함수는 datetime 값에서 월 값을 추출합니다. 반환 값의 범위는 1부터 12까지이며, 한 해의 12개월을 나타냅니다. 이 함수는 DATE 및 DATETIME 타입을 처리할 수 있습니다.

MONTH를 단위로 사용할 때 이 함수는 MySQL의 month 함수와 동일하게 동작합니다.

구문

MONTH(`<date_or_time_expr>`)

매개변수

매개변수	설명
<date_or_time_expr>	입력 datetime 값입니다. date/datetime 타입을 지원합니다. 구체적인 datetime 및 date 형식은 datetime 변환 및 date 변환을 참조하세요.

반환 값

월 값을 나타내는 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   |
+--------+