YEAR_OF_WEEK

설명

YEAR_OF_WEEK 함수는 ISO 8601 주차 달력 표준에 따라 지정된 날짜의 주차 연도(주가 속하는 연도)를 반환합니다. 일반적인 연도와 달리 ISO 주차 연도는 주 단위로 계산합니다. 한 해의 첫 주는 그해의 4번째 날이 포함된 주이며, 해당 연도에 속하는 날이 최소 4일이어야 합니다.

입력 날짜의 연도를 단순히 반환하는 year 함수와 달리, YEAR_OF_WEEK는 ISO 주차 달력 표준을 따릅니다.

자세한 내용은 ISO 주차 날짜를 참조하세요.

별칭

• YOW

구문

YEAR_OF_WEEK(`<date_or_time_expr>`)
YOW(`<date_or_time_expr>`)

매개변수

매개변수	설명
<date_or_time_expr>	입력 날짜 및 시간 값으로, date/datetime 타입을 지원합니다. datetime 및 date 형식에 대한 자세한 내용은 datetime 변환과 date 변환을 참조하세요.

반환 값

SMALLINT 타입을 반환하며, ISO 8601 주차 달력 표준에 따라 계산한 주차 연도를 나타냅니다.

• 반환 값의 범위는 일반적으로 1-9999입니다.
• 입력값이 NULL이면 NULL을 반환합니다.
• 입력값이 DATETIME 타입이면 날짜 부분만 고려하고 시간 부분은 무시합니다.

예제

-- 2005-01-01 is Saturday, this week starts from 2004-12-27, contains more days in 2004, belongs to 2004
SELECT YEAR_OF_WEEK('2005-01-01') AS yow_result;
+------------+
| yow_result |
+------------+
|       2004 |
+------------+

-- Using alias YOW, same result
SELECT YOW('2005-01-01') AS yow_alias_result;
+------------------+
| yow_alias_result |
+------------------+
|             2004 |
+------------------+

-- 2005-01-03 is Monday, this week (2005-01-03 to 2005-01-09) is the first week of 2005
SELECT YEAR_OF_WEEK('2005-01-03') AS yow_result;
+------------+
| yow_result |
+------------+
|       2005 |
+------------+

-- 2023-01-01 is Sunday, this week starts from 2022-12-26, belongs to the last week of 2022
SELECT YEAR_OF_WEEK('2023-01-01') AS yow_result;
+------------+
| yow_result |
+------------+
|       2022 |
+------------+

-- 2023-01-02 is Monday, this week (2023-01-02 to 2023-01-08) is the first week of 2023
SELECT YEAR_OF_WEEK('2023-01-02') AS yow_result;
+------------+
| yow_result |
+------------+
|       2023 |
+------------+

-- DATETIME type input, ignoring time part
SELECT YEAR_OF_WEEK('2005-01-01 15:30:45') AS yow_datetime;
+--------------+
| yow_datetime |
+--------------+
|         2004 |
+--------------+

-- Cross-year boundary case: 2024-12-30 is Monday, belongs to the first week of 2025
SELECT YEAR_OF_WEEK('2024-12-30') AS yow_result;
+------------+
| yow_result |
+------------+
|       2025 |
+------------+

-- Input is NULL, returns NULL
SELECT YEAR_OF_WEEK(NULL) AS yow_null;
+----------+
| yow_null |
+----------+
|     NULL |
+----------+