在 Django 中，iso_year 是一个用于日期字段条件查询的特殊关键字，用于提取 ISO 周年（ISO year）的功能。ISO 周年是指基于 ISO 8601 标准的年份，与常规的日历年份不同。它与周的起始和结束日期相关联，因此在一年的开始或结束可能会与常规的日历年份不同。
语法
iso_year 可以在查询表达式中用于日期字段，形式为：
<field_name>__iso_year
作用
iso_year 用于从日期字段中提取 ISO 周年，这使得在日期条件查询中，我们可以根据 ISO 周年来进行过滤和聚合。
使用方法
iso_year 的使用方式与其他查询表达式类似，通过在查询中使用 __iso_year 来指定对应日期字段的 ISO 周年。可以用在 filter() 、 exclude() 、 annotate() 等查询方法中。
使用场景
一些应用场景可能需要根据 ISO 周年来过滤数据，例如需要统计或展示某一特定 ISO 周年的数据。因为 ISO 周年与常规年份有时会不一致，所以在某些业务逻辑中使用 iso_year 会更合适。
示例代码
现在，让我们通过一个代码示例来演示 iso_year 的使用：
假设我们有一个 Django 模型 Event，其中包含一个日期字段 event_date 表示事件发生的日期。
# models.py
from django.db import models
class Event(models.Model):
name = models.CharField(max_length=100)
event_date = models.DateField()
现在，我们希望查询出某个特定 ISO 周年的所有事件。假设我们要查询 ISO 周年为 2023 年的所有事件：
from django.db.models.functions import ExtractISOYear
from datetime import date
# 假设数据库中有一些 Event 数据
# 查询 ISO 周年为 2023 年的所有事件
events_in_iso_year_2023 = Event.objects.filter(event_date__iso_year=2023)
# 输出查询结果
for event in events_in_iso_year_2023:
print(event.name, event.event_date)
在这个例子中，event_date__iso_year=2023 表示我们要查询 ISO 周年为 2023 年的数据。Django 会自动解析 iso_year 查询，并从日期字段中提取 ISO 周年进行比较。