Django 中实现按月统计并累加总数的完整教程-Python教程-PHP中文网

本文详解如何在 django 中对 queryset 按月份分组统计条目数，并在视图层动态计算累计总数，同时支持前端图表渲染所需的结构化数据输出。

本文详解如何在 django 中对 queryset 按月份分组统计条目数，并在视图层动态计算累计总数，同时支持前端图表渲染所需的结构化数据输出。

在 Django 开发中，常需对时间序列数据（如用户每日打卡、日志记录等）进行按月聚合统计，并进一步生成累计值用于仪表盘或图表展示。你当前的查询已成功使用 TruncMonth 和 annotate 实现了按月分组计数：

stats = EntryMonitoring.objects.filter(student_id=user).annotate(
    month=TruncMonth('date')
).values('month').annotate(total=Count('id'))

该 QuerySet 返回类似如下结果：

[
    {'month': datetime.date(2024, 3, 1), 'total': 25},
    {'month': datetime.date(2024, 4, 1), 'total': 1}
]

但直接在模板中循环 {{ obj.total }} 得到 251（即字符串拼接），既无法求和，也不利于图表渲染——因为前端图表库（如 Chart.js）通常需要明确的 labels（月份）和 data（对应数值）数组。

✅ 正确做法是：在视图层完成累计计算，并为每条记录附加 cumulative_total 字段，而非依赖模板逻辑或客户端 JavaScript 累加（易出错且不可靠）。

Django

避免常见的 Django 错误——QuerySet 评估、N+1 查询、迁移冲突和 ORM 陷阱。

下载

✅ 推荐实现方式（基于 Class-Based View）

from django.db.models import Count
from django.db.models.functions import TruncMonth
from django.views.generic import ListView
from .models import EntryMonitoring

class MonthlyStatListView(ListView):
    model = EntryMonitoring
    template_name = 'stats/monthly_chart.html'
    context_object_name = 'monthly_stats'

    def get_queryset(self):
        user = self.request.user  # 或根据实际逻辑获取 user 对象（如 URL 参数）
        queryset = EntryMonitoring.objects.filter(
            student_id=user
        ).annotate(
            month=TruncMonth('date')
        ).values('month').annotate(
            total=Count('id')
        ).order_by('month')  # ⚠️ 关键：必须排序，确保累计顺序正确！

        # 计算累计总数
        cumulative = 0
        result = []
        for item in queryset:
            cumulative += item['total']
            item['cumulative_total'] = cumulative
            result.append(item)

        return result

? 注意：order_by('month') 不可省略！若月份无序（如 4月在 3月前），累计值将逻辑错误。

? 模板中使用示例（适配 Chart.js）

在 monthly_chart.html 中，可结构化输出为 JSON 友好格式：

<script>
const labels = {{ monthly_stats|json_script:"chart-labels" }};
const data = {{ monthly_stats|json_script:"chart-data" }};

// 解析为 JS 数组（需配合自定义过滤器或安全转义）
const months = {{ monthly_stats|map:"month"|join:","|safe }};
const totals = {{ monthly_stats|map:"total"|join:","|safe }};
const cumulatives = {{ monthly_stats|map:"cumulative_total"|join:","|safe }};

// Chart.js 初始化
new Chart(document.getElementById('monthlyChart'), {
    type: 'bar',
    data: {
        labels: [{{ months }}],
        datasets: [{
            label: '每月新增',
            data: [{{ totals }}],
            backgroundColor: 'rgba(54, 162, 235, 0.6)'
        }, {
            label: '累计总数',
            data: [{{ cumulatives }}],
            type: 'line',
            borderColor: '#ff6384',
            fill: false
        }]
    }
});
</script>

? 进阶提示：如需更高性能（尤其数据量大时），可改用数据库层累计（PostgreSQL 的 SUM() OVER (ORDER BY ...)），但需 extra() 或原生 SQL；而上述 Python 层累计简洁可靠，适用于中小规模数据。