手册

Django教程

简介环境安装和入门创建项目创建应用程序视图模板模型添加成员添加模板添加记录删除记录更新记录

Django模板

模板变量模板标签 If Else For 循环注释迭代扩展包含过滤器

Django QuerySets

QuerySet 集合 QuerySet 获取数据 QuerySet 过滤方法 QuerySet 排序方法

Django参考手册

标签参考过滤器参考字段查找参考

首页后端开发 Django Django 教程

QuerySet 过滤方法

阅读1854

更新时间2025-08-21

QuerySet 获取数据

QuerySet 排序方法

Django QuerySet 过滤方法

filter() 方法用于过滤您的搜索，并允许您仅返回与搜索词匹配的行。

正如我们在上一章中学到的，我们可以像这样过滤字段名称:

实例

只返回firstname为"Emil"的记录:

mydata = Members.objects.filter(firstname='Emil').values()

结果

在 SQL 中，上面的语句会这样写:

SELECT * FROM members WHERE firstname = 'Emil';

AND

filter() 方法将参数作为 **kwargs（关键字参数），因此您可以通过用逗号分隔多个字段来过滤多个字段。

实例

返回 lastname 为 "Refsnes" id 为 2 的记录:

mydata = Members.objects.filter(lastname='Refsnes', id=2).values()

结果

在 SQL 中，上面的语句会这样写:

SELECT * FROM members WHERE   lastname = 'Refsnes' AND id = 2;

OR

返回 firstname 为 Emil 或 firstname 为 Tobias 的记录（意思是:返回匹配任一查询的记录，不一定两者都匹配）不像上面的 AND 示例那么容易。

我们可以使用多个 filter() 方法，由管道 | 字符分隔。结果将合并到一个模型中。

实例

返回 firstname 是 "Emil" 或 Tobias" 的记录:

mydata = Members.objects.filter(firstname='Emil').values() | Members.objects.filter(firstname='Tobias').values()

结果

另一种常用的方法是导入和使用Q表达式:

实例

返回 firstname 是 "Emil" 或 Tobias" 的记录:

from django.http import HttpResponse
from django.template import loader
from .models import Members
from django.db.models import Q

def testing(request):
  mydata = Members.objects.filter(Q(firstname='Emil') | Q(firstname='Tobias')).values()
  template = loader.get_template('testing_queries.html')
  context = {
    'mymembers': mydata,
  }
  return HttpResponse(template.render(context, request))

结果

在 SQL 中，上面的语句会这样写:

SELECT * FROM members WHERE   firstname = 'Emil' OR firstname = 'Tobias';

字段查找

Django 有自己的方式来指定 SQL 语句和 WHERE 子句。

要明确 Django 中的 where 子句，请使用"字段查找"。

字段查找是表示特定 SQL 关键字的关键字。

实例:

.filter(firstname__startswith='L');

同SQL语句:

WHERE firstname LIKE '%L'

上述语句将返回 firstname 以 'L' 开头的记录。

字段查找语法

所有字段查找关键字必须用字段名指定，后跟两个(!)下划线字符和关键字。

在我们的 Members 模型中，语句会这样写:

实例

返回 firstname 以字母 'L' 开头的记录:

mydata = Members.objects.filter(firstname__startswith='L').values()

结果

字段查找参考

所有字段查找关键字的列表:

关键字	描述说明
contains	包含短语
icontains	与 contains 相同，但不区分大小写
date	匹配日期
day	匹配日期（月份中的某天，1-31）（用于日期）
endswidth	以...结束
iendswidth	与endswidth相同，但不区分大小写
exact	完全匹配
iexact	完全相同，但不区分大小写
in	匹配其中一个值
isnull	匹配 NULL 值
gt	大于
gte	大于或等于
hour	匹配一个小时（日期时间）
lt	小于
lte	小于或等于
minute	匹配一分钟（用于日期时间）
month	匹配一个月（用于日期）
quarter	匹配一年中的一个季度 (1-4)（用于日期）
range	匹配区间
regex	匹配正则表达式
iregex	与正则表达式相同，但不区分大小写
second	匹配一秒（用于日期时间）
startswidth	开始，区分大小写
istartswidth	与startswidth相同，但不区分大小写
time	匹配时间（用于日期时间）
week	匹配周数 (1-53)（用于日期）
week_day	匹配一周中的某一天 (1-7) 1 是星期日
iso_week_day	匹配 ISO 8601 星期几 (1-7) 1 是星期一
year	匹配一年（用于日期）
iso_year	匹配 ISO 8601 年份（用于日期）

QuerySet 获取数据

QuerySet 排序方法