YEARS_DIFF

説明

YEARS_DIFF関数は、2つの日付または時刻値間の完全な年差を計算するために使用され、結果は開始時刻から終了時刻までの年数になります。DATEおよびDATETIME型の処理をサポートし、計算時に完全な時間差（月、日、時、分、秒を含む）を考慮します。

構文

YEARS_DIFF(`<date_or_time_expr1>`, `<date_or_time_expr2>`)

パラメータ

Parameter	デスクリプション
<date_or_time_expr1>	終了日付。date/datetimeタイプをサポートします。datetimeおよびdate形式については、datetime conversionおよびdate conversionを参照してください
<date_or_time_expr2>	開始日付。date/datetimeタイプおよび日付時刻形式に準拠した文字列をサポートします

Return Value

<date_or_time_expr1>と<date_or_time_expr2>の間の完全な年差を表すINTタイプの整数を返します：

• <date_or_time_expr1>が<date_or_time_expr2>より後の場合、正の数を返します（「完全な年」の条件を満たす必要があります。例：'2022-03-15 08:30:00'と'2021-03-15 09:10:00'は実際には1年未満の差のため、0を返します）。
• <date_or_time_expr1>が<date_or_time_expr2>より前の場合、負の数を返します（計算方法は上記と同様で、結果が反転されます）。
• 入力がDATEタイプの場合、時刻部分はデフォルトで00:00:00になります。
• パラメータがNULLの場合、NULLを返します。
• 特別なうるう年の2月のケース（例：2024年はうるう年で、2月29日と2023年2月28日は完全な1年を構成します）

Examples

-- Year difference of 1 year, and month-day equal (full year)
SELECT YEARS_DIFF('2020-12-25', '2019-12-25') AS diff_full_year;
+----------------+
| diff_full_year |
+----------------+
|              1 |
+----------------+

-- Year difference of 1 year, but end month-day earlier than start month-day (less than a year)
SELECT YEARS_DIFF('2020-11-25', '2019-12-25') AS diff_less_than_year;
+---------------------+
| diff_less_than_year |
+---------------------+
|                   0 |
+---------------------+

-- DATETIME type with time components
SELECT YEARS_DIFF('2022-03-15 08:30:00', '2021-03-15 09:10:00') AS diff_datetime;
+---------------+
| diff_datetime |
+---------------+
|             0 |
+---------------+

-- Mixed DATE and DATETIME calculation, DATE type input defaults time part to 00:00:00
SELECT YEARS_DIFF('2024-05-20', '2020-05-20 12:00:00') AS diff_mixed;
+------------+
| diff_mixed |
+------------+
|          3 |
+------------+

-- End time earlier than start time, returns negative number
SELECT YEARS_DIFF('2018-06-10', '2020-06-10') AS diff_negative;
+---------------+
| diff_negative |
+---------------+
|            -2 |
+---------------+

-- Special leap year February case (2024 is a leap year, February 29th vs February 28th 2023, constitutes a full year)
SELECT YEARS_DIFF('2024-02-29', '2023-02-28') AS leap_year_diff;
+----------------+
| leap_year_diff |
+----------------+
|              1 |
+----------------+

-- Any parameter is NULL (returns NULL)
SELECT 
  YEARS_DIFF(NULL, '2023-03-15') AS null_input1,
  YEARS_DIFF('2023-03-15', NULL) AS null_input2;
+-------------+-------------+
| null_input1 | null_input2 |
+-------------+-------------+
| NULL        | NULL        |
+-------------+-------------+