DAYOFYEAR

説明

DAYOFYEAR 関数は、日付または日時式がその年の何日目に当たるかを計算します。戻り値は、1（一月1日）から 366（うるう年の十二月31日）までの整数です。

この関数の動作は、MySQL の dayofyear 関数 と同じです。

別名

• DOY

構文

DAYOFYEAR(<date_or_time_expr>)

パラメータ

パラメータ	説明
<date_or_time_expr>	DATE、DATETIME、TIMESTAMP_NS 型をサポートする有効な日付式です。日時と日付の形式については、日時変換と日付変換を参照してください。

戻り値

その年の何日目かを表す SMALLINT 型の整数（1～366）を返します。

特殊なケース：

• <date_or_time_expr> が NULL の場合、NULL を返します。
• うるう年の二月29日は、その年の 60 日目として正しく計算されます。

例

---Extract the day number in the year from datetime type
select dayofyear('2007-02-03 00:00:00');

+----------------------------------+
| dayofyear('2007-02-03 00:00:00') |
+----------------------------------+
|                               34 |
+----------------------------------+

---Extract day number from date type
select dayofyear('2023-12-31');
+-------------------------+
| dayofyear('2023-12-31') |
+-------------------------+
|                     365 |
+-------------------------+


---Calculate day number in a leap year
select dayofyear('2024-12-31');
+-------------------------+
| dayofyear('2024-12-31') |
+-------------------------+
|                     366 |
+-------------------------+

---Input is NULL, returns NULL
select dayofyear(NULL);
+-----------------+
| dayofyear(NULL) |
+-----------------+
|            NULL |
+-----------------+