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。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。