如何在Django中基于GMT周数实现数据库/模型数据的新增、查看与排序

以下是从工具函数到视图层的全流程可落地代码：

1. 首先实现周数转换工具函数 #

Python原生isocalendar默认周一是周第一天，我们通过日期偏移适配周日为周首的规则：

from django.utils import timezone
import datetime
import pytz

def date_to_gmt_week(date_obj):
    """将任意时区的日期转换为GMT规则的（年，周数）元组"""
    gmt_date = date_obj.astimezone(pytz.UTC)
    # 偏移1天，对齐isocalendar的周计算逻辑：周日+1天=周一，归属同一周
    adjusted_date = gmt_date + datetime.timedelta(days=1)
    year, week, _ = adjusted_date.isocalendar()
    return year, week

def gmt_week_to_date_range(week_str: str):
    """将`2021-30`格式的周字符串转换为GMT时区的周起止时间（含首尾完整天）"""
    year, week = map(int, week_str.split("-"))
    # 取对应isocalendar周的周一，减1天得到我们要的周日作为周首
    week_first_day = datetime.datetime.fromisocalendar(year, week, 1) - datetime.timedelta(days=1)
    # 周首加6天得到周六作为周尾
    week_last_day = week_first_day + datetime.timedelta(days=6)
    # 转换为带时区的起止时间，覆盖全天时分秒
    gmt_start = pytz.UTC.localize(datetime.datetime.combine(week_first_day, datetime.time.min))
    gmt_end = pytz.UTC.localize(datetime.datetime.combine(week_last_day, datetime.time.max))
    return gmt_start, gmt_end

注：Python 3.8+才支持fromisocalendar方法，低版本可以用第三方isoweek库替换实现相同逻辑。

2. 模型层优化（可选，大幅提升查询效率） #

如果周查询是高频场景，建议在模型里增加冗余的周字段做索引，避免每次查询都做日期计算：

from django.db import models

class YourBusinessModel(models.Model):
    # 原有业务字段
    content = models.TextField()
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)
    # 新增周冗余字段，加索引加速查询
    gmt_year = models.IntegerField(editable=False, db_index=True)
    gmt_week = models.IntegerField(editable=False, db_index=True)

    def save(self, *args, **kwargs):
        # 保存时自动计算所属周，用created_at还是updated_at按需调整
        self.gmt_year, self.gmt_week = date_to_gmt_week(self.updated_at)
        super().save(*args, **kwargs)

3. 视图层核心逻辑 #

实现默认返回当前周数据，支持传入week查询参数拉取历史周数据：

from django.shortcuts import render
from .models import YourBusinessModel
from .utils import date_to_gmt_week, gmt_week_to_date_range

def week_data_list(request):
    # 1. 处理周参数，无参数默认用当前GMT周
    target_week = request.GET.get("week")
    if not target_week:
        current_year, current_week = date_to_gmt_week(timezone.now())
        target_week = f"{current_year}-{current_week}"
    
    # 2. 参数合法性校验，非法参数 fallback 到当前周
    try:
        week_start, week_end = gmt_week_to_date_range(target_week)
    except (ValueError, TypeError):
        current_year, current_week = date_to_gmt_week(timezone.now())
        target_week = f"{current_year}-{current_week}"
        week_start, week_end = gmt_week_to_date_range(target_week)
    
    # 3. 查询数据
    # 方案A：没有加冗余字段的话直接用时间范围查询
    data_queryset = YourBusinessModel.objects.filter(updated_at__range=(week_start, week_end))
    # 方案B：加了冗余字段的话用索引查询，性能更好
    # year, week = map(int, target_week.split("-"))
    # data_queryset = YourBusinessModel.objects.filter(gmt_year=year, gmt_week=week)

    return render(request, "your_template.html", {
        "data_list": data_queryset,
        "active_week": target_week
    })

4. 前端对接说明 #

前端周选择器只需要输出YYYY-WW格式的字符串，作为week查询参数传给后端接口即可，比如请求/your-endpoint?week=2021-30就能拉取对应周的数据。

注意事项 #

• 所有日期计算统一用GMT时区处理，避免不同时区用户的时间计算偏差
• isocalendar已经自动处理了跨年周的边界问题，不需要额外做兼容判断

内容的提问来源于stack exchange，提问作者Ashish George Jose