字段查询是指如何指定SQL WHERE子句的内容。它们用作QuerySet的filter(), exclude()和get()方法的关键字参数。
默认查找类型为exact。
下表列出了所有的字段查询参数:
字段名 | 说明 |
---|---|
exact | 精确匹配 |
iexact | 不区分大小写的精确匹配 |
contains | 包含匹配 |
icontains | 不区分大小写的包含匹配 |
in | 在..之内的匹配 |
gt | 大于 |
gte | 大于等于 |
lt | 小于 |
lte | 小于等于 |
startswith | 从开头匹配 |
istartswith | 不区分大小写从开头匹配 |
endswith | 从结尾处匹配 |
iendswith | 不区分大小写从结尾处匹配 |
range | 范围匹配 |
date | 日期匹配 |
year | 年份 |
month | 月份 |
day | 日期 |
week | 第几周 |
week_day | 周几 |
time | 时间 |
hour | 小时 |
minute | 分钟 |
second | 秒 |
isnull | 判断是否为空 |
search | 1.10中被废弃 |
regex | 区分大小写的正则匹配 |
iregex | 不区分大小写的正则匹配 |
精确匹配。 默认的查找类型!
Entry.objects.get(id__exact=14) Entry.objects.get(id__exact=None)
不区分大小写的精确匹配。
Blog.objects.get(name__iexact='beatles blog') Blog.objects.get(name__iexact=None)
第一个查询将匹配 'Beatles Blog', 'beatles blog', 'BeAtLes BLoG'等等。
大小写敏感的包含关系匹配。
Entry.objects.get(headline__contains='Lennon')
这将匹配标题'Lennon honored today',但不匹配'lennon honored today'。
不区分大小写的包含关系匹配。
Entry.objects.get(headline__icontains='Lennon')
在给定的列表里查找。
Entry.objects.filter(id__in=[1, 3, 4])
还可以使用动态查询集,而不是提供文字值列表:
inner_qs = Blog.objects.filter(name__contains='Cheddar') entries = Entry.objects.filter(blog__in=inner_qs)
或者从values()或values_list()
中获取的QuerySet作为比对的对象:
inner_qs = Blog.objects.filter(name__contains='Ch').values('name') entries = Entry.objects.filter(blog__name__in=inner_qs)
下面的例子将产生一个异常,因为试图提取两个字段的值,但是查询语句只需要一个字段的值:
# 错误的实例,将弹出异常。 inner_qs = Blog.objects.filter(name__contains='Ch').values('name', 'id') entries = Entry.objects.filter(blog__name__in=inner_qs)
大于
Entry.objects.filter(id__gt=4)
大于或等于
小于
小于或等于
区分大小写,从开始位置匹配。
注意:对于SQLite数据库,不支持大小写区分的模式。
Entry.objects.filter(headline__startswith='Lennon')
不区分大小写,从开始位置匹配。
Entry.objects.filter(headline__istartswith='Lennon')
区分大小写,从结束未知开始匹配。
Entry.objects.filter(headline__endswith='Lennon')
不区分大小写,从结束未知开始匹配。
Entry.objects.filter(headline__iendswith='Lennon')
范围测试(包含于之中)。
import datetime start_date = datetime.date(2005, 1, 1) end_date = datetime.date(2005, 3, 31) Entry.objects.filter(pub_date__range=(start_date, end_date))
警告:过滤具有日期的DateTimeField不会包含最后一天,因为边界被解释为“给定日期的0am”。
进行日期对比。
Entry.objects.filter(pub_date__date=datetime.date(2005, 1, 1)) Entry.objects.filter(pub_date__date__gt=datetime.date(2005, 1, 1))
当USE_TZ
为True时,字段将转换为当前时区,然后进行过滤。
对年份进行匹配。
Entry.objects.filter(pub_date__year=2005) Entry.objects.filter(pub_date__year__gte=2005)
当USE_TZ
为True时,在过滤之前,datetime字段将转换为当前时区。
对月份进行匹配。取整数1(1月)至12(12月)。
Entry.objects.filter(pub_date__month=12) Entry.objects.filter(pub_date__month__gte=6)
当USE_TZ为True时,在过滤之前,datetime字段将转换为当前时区。
对具体到某一天的匹配。
Entry.objects.filter(pub_date__day=3) Entry.objects.filter(pub_date__day__gte=3)
当USE_TZ为True时,在过滤之前,datetime字段将转换为当前时区。
Django1.11中的新功能。根据ISO-8601返回周号(1-52或53),即星期一开始的星期,星期四或之前的第一周。
Entry.objects.filter(pub_date__week=52) Entry.objects.filter(pub_date__week__gte=32, pub_date__week__lte=38)
当USE_TZ为True时,字段将转换为当前时区,然后进行过滤。
进行“星期几”匹配。 取整数值,星期日为1,星期一为2,星期六为7。
Entry.objects.filter(pub_date__week_day=2) Entry.objects.filter(pub_date__week_day__gte=2)
当USE_TZ为True时,在过滤之前,datetime字段将转换为当前时区。
Django1.11中的新功能。
将字段的值转为datetime.time格式并进行对比。
Entry.objects.filter(pub_date__time=datetime.time(14, 30)) Entry.objects.filter(pub_date__time__between=(datetime.time(8), datetime.time(17)))
USE_TZ为True时,字段将转换为当前时区,然后进行过滤。
对小时进行匹配。 取0和23之间的整数。
Event.objects.filter(timestamp__hour=23) Event.objects.filter(time__hour=5) Event.objects.filter(timestamp__hour__gte=12)
当USE_TZ为True时,值将过滤前转换为当前时区。
对分钟匹配。取0和59之间的整数。
Event.objects.filter(timestamp__minute=29) Event.objects.filter(time__minute=46) Event.objects.filter(timestamp__minute__gte=29)
当USE_TZ为True时,值将被过滤前转换为当前时区。
对秒数进行匹配。取0和59之间的整数。
Event.objects.filter(timestamp__second=31) Event.objects.filter(time__second=2) Event.objects.filter(timestamp__second__gte=31)
当USE_TZ为True时,值将过滤前转换为当前时区。
值为False或True, 相当于SQL语句IS NULL和IS NOT NULL.
Entry.objects.filter(pub_date__isnull=True)
自1.10版以来已弃用。
区分大小写的正则表达式匹配。
Entry.objects.get(title__regex=r'^(An?|The) +')
建议使用原始字符串(例如,r'foo'而不是'foo')来传递正则表达式语法。
不区分大小写的正则表达式匹配。
Entry.objects.get(title__iregex=r'^(an?|the) +')
Django的django.db.models
模块提供以下聚合函数。
引用模型字段的一个字符串,或者一个query expression。
用来表示返回值的model field,一个可选的参数。
**extra
关键字参数可以给聚合函数生成的SQL提供额外的信息。
class Avg(expression, output_field=FloatField(), **extra)[source]
返回给定表达式的平均值,它必须是数值,除非指定不同的output_field
。
默认的别名:<field>__avg 返回类型:float(或指定任何output_field的类型)
class Count(expression, distinct=False, **extra)[source]
返回与expression相关的对象的个数。
默认的别名:<field>__count 返回类型:int 有一个可选的参数:distinct。如果distinct=True,Count 将只计算唯一的实例。默认值为False。
class Max(expression, output_field=None, **extra)[source]
返回expression的最大值。
默认的别名:<field>__max 返回类型:与输入字段的类型相同,如果提供则为`output_field`类型
class Min(expression, output_field=None, **extra)[source]
返回expression的最小值。
默认的别名:<field>__min 返回类型:与输入字段的类型相同,如果提供则为`output_field`类型
class StdDev(expression, sample=False, **extra)[source]
返回expression的标准差。
默认的别名:<field>__stddev 返回类型:float 有一个可选的参数:sample。默认情况下,返回群体的标准差。如果sample=True,返回样本的标准差。 SQLite 没有直接提供StdDev。
class Sum(expression, output_field=None, **extra)[source]
计算expression的所有值的和。
默认的别名:<field>__sum 返回类型:与输入字段的类型相同,如果提供则为output_field类型
class Variance(expression, sample=False, **extra)[source]
返回expression的方差。
默认的别名:<field>__variance 返回类型:float 有一个可选的参数:sample。 SQLite 没有直接提供Variance。