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       |
+------------+