YEAR

概要

YEAR関数は、指定された日付または時刻値から年の部分を抽出し、年を整数として返します。DATEとDATETIME型の処理をサポートしています。

この関数は、MySQLのyear functionと一貫した動作をします。

構文

YEAR(`<date_or_time_expr>`)

パラメータ

パラメータ	説明
<date_or_time_expr>	年を抽出する対象のdatetime値。date/datetimeタイプをサポートします。datetimeとdateフォーマットについては、datetime conversionとdate conversionを参照してください

戻り値

date/datetimeタイプの年の部分を返します。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       |
+------------+