如何在Django Func()表达式中指定多参数的传入顺序？

核心思路 #

自定义Func表达式时，需通过template属性用{0}、{1}（索引从0开始）明确映射传入的参数顺序，结合目标数据库的日期语法实现工作日计算。以下分主流数据库给出可运行的实现方案：

1. PostgreSQL 实现 #

利用generate_series生成日期序列，过滤周六（EXTRACT(DOW) = 6）和周日（EXTRACT(DOW) = 0）：

from django.db.models import Func, IntegerField, F

class WorkDays(Func):
    template = """
        SELECT COUNT(*)
        FROM generate_series(LEAST({0}, {1}), GREATEST({0}, {1}), '1 day'::interval) AS days(d)
        WHERE EXTRACT(DOW FROM days.d) NOT IN (0, 6)
    """
    output_field = IntegerField()
    arity = 2  # 固定接收2个日期参数

# 使用示例：给Event模型添加工作日数字段
Event.objects.annotate(
    work_days=WorkDays(F('start_date'), F('end_date'))
)

2. MySQL 实现 #

通过生成日期序列，用WEEKDAY过滤周六（5）和周日（6）：

from django.db.models import Func, IntegerField, F

class WorkDays(Func):
    template = """
        SELECT COUNT(*)
        FROM (
            SELECT ADDDATE({0}, INTERVAL seq DAY) AS day
            FROM (SELECT 0 UNION ALL SELECT 1 UNION ALL SELECT 2 UNION ALL SELECT 3 UNION ALL SELECT 4 UNION ALL SELECT 5 UNION ALL SELECT 6) AS seqs
            JOIN (SELECT (DATEDIFF({1}, {0}) + 1) AS days) AS diff
            WHERE seq < days
        ) AS dates
        WHERE WEEKDAY(day) NOT IN (5, 6)
    """
    output_field = IntegerField()
    arity = 2

# 使用示例
Event.objects.annotate(
    work_days=WorkDays(F('start_date'), F('end_date'))
)

常见报错原因修正 #

• 禁止使用%(expressions)s[1]或%s：%(expressions)s是Django批量替换所有参数的占位符，无法直接索引；原生%s不兼容Django的参数绑定逻辑。
• 日期顺序问题：用LEAST和GREATEST包裹参数，确保不管传入的起始/结束日期顺序如何，都能生成正确的日期序列。
• 数据库语法差异：不同数据库的工作日判断函数（如PostgreSQL的EXTRACT(DOW)、MySQL的WEEKDAY）逻辑不同，需对应调整过滤条件。

内容的提问来源于stack exchange，提问作者Genarito