Django Admin 自定义时间区间筛选器 DateRangeFilter 配置指南

Django Admin 时间筛选功能概述

Django 的 Admin 管理后台内置了多种实用功能，如搜索框和基础筛选器等，这些功能不仅代码实现简单，而且功能强大，能够显著提升开发效率。

然而，Django 默认提供的时间筛选功能存在一定局限，仅支持从特定时间节点到当前时间的范围筛选，无法满足自由定义任意时间段的需求。为解决这一问题，本文介绍一款名为 DateRangeFilter 的第三方插件，它能够实现自定义时间区间的筛选功能。

需要注意的是，DateRangeFilter 插件仅兼容 Django 1.4 及更高版本，使用前请确认项目版本符合要求。

DateRangeFilter 插件安装与配置

插件安装

可以通过 pip 或 easy_install 工具进行安装，具体命令如下：

pip install django-daterange-filter

修改项目配置

打开项目的 settings.py 文件，在 INSTALLED_APPS 列表中注册该插件，配置如下：

INSTALLED_APPS = (
  ...
  'daterange_filter'
)

Admin 页面筛选器注册方法

注册筛选器

假设在 models.py 中，你需要对普通字段和时间区间字段进行筛选，模型定义大致如下：

class TaskModel(models.Model):
  ...
  user_name = models.CharField(u'用户名', max_length=128)
  submit_time = models.DateTimeField(u'提交时间', auto_now_add=True)
  ...

接下来，在 admin.py 文件中引入 DateRangeFilter 插件，具体导入语句为：

from daterange_filter.filter import DateRangeFilter

上述导入步骤在官方文档中容易被忽略，因此在此特别强调，请确保正确引入该模块。

在 admin.py 中，完整的 DateRangeFilter 筛选器配置应如下所示：

from daterange_filter.filter import DateRangeFilter
from django.contrib import admin
from models import TaskModel

class TaskAdmin(admin.ModelAdmin):
  list_filter = (
    'user_name',
    ('submit_time', DateRangeFilter), # this is a tuple
    ...
  )

完成上述配置并注册到 Admin 页面后，即可在后台管理界面中看到自定义时间区间筛选的效果。

参考链接：https://pypi.org/project/django-daterange-filter/1.1.1/

Django ORM 时间与数字比较技巧

补充知识：Python Django ORM 时间过滤与数字比较方法

首先介绍富比较方法在实际工作中的应用场景，其中时间比较和数字比较最为常用。例如，在创建信息时，若时间重叠或冲突，则不允许创建成功，此时便需利用比较方法进行逻辑判断。

filter(
      (Q(start_time1__lt=start_time2) & Q(end_time1__gt=end_time2)) |
      Q(start_time1__range=(start_time, end_time)) |
      Q(end_time1__range=(start_time, end_time))）

以上代码中，__lt 表示小于，即 start_time1 小于 start_time2；同时 end_time1 大于 end_time2 使用 __gt 表示大于。

‘|' 符号表示逻辑或，__range 用于指定时间范围，即时间处于 start_time 到 end_time 之间。

以上即为 Django Admin 自定义时间区间筛选器 DateRangeFilter 的完整介绍，希望能为读者提供参考，欢迎支持本站更多内容。