YEAR

설명

YEAR 함수는 지정한 날짜 또는 시간 값에서 연도 부분을 추출하여 정수로 반환합니다. DATE, DATETIME 및 TIMESTAMP_NS 타입을 지원합니다.

이 함수는 MySQL의 year 함수와 동일하게 동작합니다.

구문

YEAR(`<date_or_time_expr>`)

매개변수

매개변수	설명
<date_or_time_expr>	연도를 추출할 날짜 및 시간 값으로, DATE/DATETIME/TIMESTAMP_NS 타입을 지원합니다. 날짜 및 시간 형식과 날짜 형식은 날짜 및 시간 변환과 날짜 변환을 참조하세요.

반환 값

DATE/DATETIME/TIMESTAMP_NS 타입의 연도 부분을 INT 타입으로 반환하며, 범위는 0-9999입니다.

• 입력 매개변수가 NULL이면 NULL을 반환합니다.

예제

-- Extract year from DATE type
SELECT YEAR('1987-01-01') AS year_date;
+-----------+
| year_date |
+-----------+
|      1987 |
+-----------+

-- Extract year from DATETIME type (ignoring hours, minutes, seconds)
SELECT YEAR('2024-05-20 14:30:25') AS year_datetime;
+---------------+
| year_datetime |
+---------------+
|          2024 |
+---------------+

-- Input is NULL (returns NULL)
SELECT YEAR(NULL) AS null_input;
+------------+
| null_input |
+------------+
| NULL       |
+------------+