函数名称

DAYOFYEAR

功能描述

DAYOFYEAR 函数用于计算并返回给定日期（日期时间）在所在年份中是第几天。该函数对于日期类型的数据特别有用，可以帮助用户快速了解特定日期在整个年度中的进度。

参数说明

• expr: 输入参数为 date 或 timestamp_ltz 类型的数据。

返回结果

返回一个整数，表示给定日期在所属年份的第几天。结果范围为 1 到 365（平年）或 366（闰年）。

使用示例

1. 计算当前日期是今年第几天：

   SELECT DAYOFYEAR(CURRENT_TIMESTAMP());
   

   结果将显示当前日期在当前年份中的天数。

2. 计算某个特定日期是其年份的第几天：

   SELECT DAYOFYEAR('2023-02-10');
   

   结果将返回 41，表示 2023 年 2 月 10 日是该年的第 41 天。

3. 计算不同年份的日期天数：

   SELECT DAYOFYEAR('2022-03-31'), DAYOFYEAR('2024-03-31');
   

   结果将返回两个整数，分别为 90（2022 年 3 月 31 日是该年的第 90 天）和 91（2024 年 3 月 31 日是该年的第 91 天，因为 2024 年是闰年）。

4. 在查询中使用 DAYOFYEAR 函数与其他条件结合：

   SELECT * FROM orders WHERE DAYOFYEAR(order_date) BETWEEN 100 AND 120;
   

   此查询将返回 order_date 在当前年份的第 100 天至第 120 天之间的所有订单记录。

注意事项

• 确保输入的日期格式正确，否则可能导致函数返回错误或意外的结果。
• 当前年份的判断基于输入日期所在时区的当前时间。