Python Django QuerySet.dates用法及代码示例

本文介绍 django.db.models.query.QuerySet.dates 的用法。

声明

dates(field, kind, order='ASC')

返回一个 QuerySet ，其计算结果为 datetime.date 对象列表，表示 QuerySet 内容中特定种类的所有可用日期。

field 应该是模型的DateField 的名称。 kind 应该是 "year" 、 "month" 、 "week" 或 "day" 。结果列表中的每个 datetime.date 对象都是给定的 type 的 “truncated” 。

"year" 返回字段的所有不同年份值的列表。
"month" 返回字段的所有不同年份/月份值的列表。
"week" 返回字段的所有不同年/周值的列表。所有日期都是星期一。
"day" 返回字段的所有不同年/月/日值的列表。

order ，默认为 'ASC' ，应该是 'ASC' 或 'DESC' 。这指定了如何对结果进行排序。

例子：

>>> Entry.objects.dates('pub_date', 'year')
[datetime.date(2005, 1, 1)]
>>> Entry.objects.dates('pub_date', 'month')
[datetime.date(2005, 2, 1), datetime.date(2005, 3, 1)]
>>> Entry.objects.dates('pub_date', 'week')
[datetime.date(2005, 2, 14), datetime.date(2005, 3, 14)]
>>> Entry.objects.dates('pub_date', 'day')
[datetime.date(2005, 2, 20), datetime.date(2005, 3, 20)]
>>> Entry.objects.dates('pub_date', 'day', order='DESC')
[datetime.date(2005, 3, 20), datetime.date(2005, 2, 20)]
>>> Entry.objects.filter(headline__contains='Lennon').dates('pub_date', 'day')
[datetime.date(2005, 3, 20)]

相关用法

注：本文由纯净天空筛选整理自djangoproject.com大神的英文原创作品 django.db.models.query.QuerySet.dates。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。