在 Django 中，year 是一个用于字段条件查询的关键字，它用于从日期或日期时间字段中提取年份，并将其用于过滤查询结果。year 关键字可以用在 filter() 、 exclude() 、 annotate() 等查询方法中。
语法
<field_name>__year=<year_value>
<field_name>：需要进行条件查询的日期或日期时间字段名。<year_value>：指定的年份值，可以是一个整数或一个可用于解析为年份的字符串（例如："2023"）。
作用
year 关键字的作用是筛选出符合指定年份条件的查询结果。
使用方法
通过 <field_name>__year 的语法，我们可以在查询中指定日期或日期时间字段，并用于提取相应的年份。
使用场景
year 关键字在以下场景中非常有用：
- 时间分析报告：用于生成年度的时间分析报告，例如获取某年所有订单或事件的数据。
- 时间范围筛选：在特定年份内进行数据筛选，例如找到过去一年内的用户注册记录。
- 年份聚合 ：与
annotate()结合使用，用于对数据进行年份聚合汇总，例如计算某个字段在不同年份的总和、平均值等。
代码示例
假设我们有一个 Django 模型 Event，其中有一个日期字段 date 表示事件日期。现在我们想从数据库中查询出 2023 年的所有事件。首先，我们需要定义模型如下：
# models.py
from django.db import models
class Event(models.Model):
name = models.CharField(max_length=100)
date = models.DateField()
接下来，我们将通过 year 关键字来查询 2023 年的所有事件：
from myapp.models import Event
from datetime import date
# 查询2023年的所有事件
events_2023 = Event.objects.filter(date__year=2023)
上述代码使用 filter() 方法，其中 date__year 表示我们要从 date 字段中提取年份，并筛选出等于 2023 的记录。这将返回一个包含所有满足条件的事件对象的查询集。
同样，我们可以结合 exclude() 方法来排除特定年份的事件：
from myapp.models import Event
# 排除2023年的所有事件
events_not_2023 = Event.objects.exclude(date__year=2023)
这将返回一个查询集，其中包含所有年份不等于 2023 的事件。
此外，我们可以使用 annotate() 结合 year 关键字来实现一些年份相关的聚合操作。例如，假设我们有一个 Event 模型有一个 num_attendees 字段表示事件的参与人数，我们想计算每年的总参与人数：
from myapp.models import Event
from django.db.models import Sum
# 按年份聚合计算参与人数总和
attendees_by_year = Event.objects.values('date__year').annotate(total_attendees=Sum('num_attendees'))
上述代码使用 values() 方法指定按 date__year 字段进行聚合，然后使用 annotate() 方法结合 Sum() 函数来计算每年的参与人数总和。返回的查询集中每一项将包含 date__year 和 total_attendees 字段，分别表示年份和总参与人数。
这些是使用 year 关键字的一些常见用法，可以根据具体的业务需求来灵活运用。