Django模型层之字段查询参数及聚合函数

字段查询是指如何指定SQL WHERE子句的内容。它们用作QuerySet的filter(), exclude()和get()方法的关键字参数。

创新互联建站是网站建设技术企业，为成都企业提供专业的做网站、网站制作，网站设计，网站制作，网站改版等技术服务。拥有十余年丰富建站经验和众多成功案例，为您定制适合企业的网站。十余年品质，值得信赖！

默认查找类型为exact。

下表列出了所有的字段查询参数：

1. exact

精确匹配。 默认的查找类型！

2. iexact

不区分大小写的精确匹配。

第一个查询将匹配 'Beatles Blog', 'beatles blog', 'BeAtLes BLoG'等等。

3. contains

大小写敏感的包含关系匹配。

Entry.objects.get(headline__contains='Lennon')

这将匹配标题'Lennon honored today'，但不匹配'lennon honored today'。

4. icontains

不区分大小写的包含关系匹配。

Entry.objects.get(headline__icontains='Lennon')

5. in

在给定的列表里查找。

Entry.objects.filter(id__in=[1,3,4])

还可以使用动态查询集，而不是提供文字值列表：

或者从values()或values_list()中获取的QuerySet作为比对的对象：

下面的例子将产生一个异常，因为试图提取两个字段的值，但是查询语句只需要一个字段的值：

6. gt

大于

Entry.objects.filter(id__gt=4)

7. gte

大于或等于

8. lt

小于

9. lte

小于或等于

10. startswith

区分大小写，从开始位置匹配。

Entry.objects.filter(headline__startswith='Lennon')

11. istartswith

不区分大小写，从开始位置匹配。

Entry.objects.filter(headline__istartswith='Lennon')

12. endswith

区分大小写，从结束未知开始匹配。

Entry.objects.filter(headline__endswith='Lennon')

13. iendswith

不区分大小写，从结束未知开始匹配。

Entry.objects.filter(headline__iendswith='Lennon')

14. range

范围测试（包含于之中）。

警告:过滤具有日期的DateTimeField不会包含最后一天，因为边界被解释为“给定日期的0am”。

15. date

进行日期对比。

当USE_TZ为True时，字段将转换为当前时区，然后进行过滤。

16. year

对年份进行匹配。

当USE_TZ为True时，在过滤之前，datetime字段将转换为当前时区。

17. month

对月份进行匹配。取整数1（1月）至12（12月）。

当USE_TZ为True时，在过滤之前，datetime字段将转换为当前时区。

18. day

对具体到某一天的匹配。

当USE_TZ为True时，在过滤之前，datetime字段将转换为当前时区。

19. week

Django1.11中的新功能。根据ISO-8601返回周号（1-52或53），即星期一开始的星期，星期四或之前的第一周。

当USE_TZ为True时，字段将转换为当前时区，然后进行过滤。

20. week_day

进行“星期几”匹配。 取整数值，星期日为1，星期一为2，星期六为7。

当USE_TZ为True时，在过滤之前，datetime字段将转换为当前时区。

21. time

Django1.11中的新功能。

将字段的值转为datetime.time格式并进行对比。

USE_TZ为True时，字段将转换为当前时区，然后进行过滤。

22. hour

对小时进行匹配。 取0和23之间的整数。

当USE_TZ为True时，值将过滤前转换为当前时区。

23. minute

对分钟匹配。取0和59之间的整数。

当USE_TZ为True时，值将被过滤前转换为当前时区。

24. second

对秒数进行匹配。取0和59之间的整数。

当USE_TZ为True时，值将过滤前转换为当前时区。

25. isnull

值为False或True, 相当于SQL语句IS NULL和IS NOT NULL.

Entry.objects.filter(pub_date__isnull=True)

26. search

自1.10版以来已弃用。

27. regex

区分大小写的正则表达式匹配。

Entry.objects.get(title__regex=r'^(An?|The) +')

建议使用原始字符串（例如，r'foo'而不是'foo'）来传递正则表达式语法。

28. iregex

不区分大小写的正则表达式匹配。

Entry.objects.get(title__iregex=r'^(an?|the) +')

聚合函数

Django的django.db.models模块提供以下聚合函数。

1. expression

引用模型字段的一个字符串，或者一个query expression。

2. output_field

用来表示返回值的model field，一个可选的参数。

3. **extra

关键字参数可以给聚合函数生成的SQL提供额外的信息。

4. Avg

class Avg(expression, output_field=FloatField(), **extra)[source]

返回给定表达式的平均值，它必须是数值，除非指定不同的output_field。

5. Count

class Count(expression, distinct=False, **extra)[source]

返回与expression相关的对象的个数。

6. Max

class Max(expression, output_field=None, **extra)[source]

返回expression的最大值。

7. Min

class Min(expression, output_field=None, **extra)[source]

返回expression的最小值。

8. StdDev

class StdDev(expression, sample=False, **extra)[source]

返回expression的标准差。

.

9. Sum

class Sum(expression, output_field=None, **extra)[source]

计算expression的所有值的和。

10. Variance

class Variance(expression, sample=False, **extra)[source]

返回expression的方差。