基于日期的通用视图，提供在 django.views.generic.dates 中，是用于显示基于日期数据的向下扩展页面的视图。
ArchiveIndexViewLink to this heading#一个按日期显示“最新”对象的顶层索引页。除非你将 allow_future 设置为 True，否则不包含日期在 未来 的对象。
祖先（MRO）
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
上下文
\n除了 django.views.generic.list.MultipleObjectMixin （通过 django.views.generic.dates.BaseDateListView）提供的上下文外，模板的上下文将是：
date_list：一个 QuerySet 对象，包含根据 queryset 有对象可用的所有年份，以 datetime.datetime 对象表示，按降序排列。
注意
\n使用默认为 latest 的 context_object_name。
使用默认为 _archive 的 template_name_suffix。
默认情况下，按年提供 date_list，但可以使用 date_list_period 属性将其改为月或日。这也适用于所有子类视图。
示例 myapp/urls.py：
\nfrom django.urls import path\nfrom django.views.generic.dates import ArchiveIndexView\n\nfrom myapp.models import Article\n\nurlpatterns = [\n path(\n "archive/",\n ArchiveIndexView.as_view(model=Article, date_field="pub_date"),\n name="article_archive",\n ),\n]\n示例 myapp/article_archive.html：
\n<ul>\n {% for article in latest %}\n <li>{{ article.pub_date }}: {{ article.title }}</li>\n {% endfor %}\n</ul>\n这将输出所有文章。
\nYearArchiveViewLink to this heading#每年的存档页，显示某一年的所有可用月份。除非你把 allow_future 设置为 True，否则不显示日期在 未来 的对象。
祖先（MRO）
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
一个布尔值，用于指定是否检索今年的全部对象清单并将其传递给模板。如果 True，将向上下文提供对象清单。如果 False，将使用 None 查询集作为对象列表。默认情况下，这是 False。
确定是否将对象列表作为上下文的一部分返回。默认返回 make_object_list。
上下文
\n除了 django.views.generic.list.MultipleObjectMixin （通过 django.views.generic.dates.BaseDateListView）提供的上下文外，模板的上下文将是：
date_list。一个 QuerySet 对象，包含根据 queryset 有对象可用的所有月份，以 datetime.datetime 对象表示，按升序排列。
year：一个 date 对象，代表特定年份。
next_year： 一个:class:~datetime.date 对象，根据 allow_empty 和 allow_future，表示下一年的第一天。
previous_year： 一个 date 对象，根据 allow_empty 和 allow_future，表示前一年的第一天。
注意
\n使用默认为 _archive_year 的 template_name_suffix。
示例 myapp/views.py：
\nfrom django.views.generic.dates import YearArchiveView\n\nfrom myapp.models import Article\n\n\nclass ArticleYearArchiveView(YearArchiveView):\n queryset = Article.objects.all()\n date_field = "pub_date"\n make_object_list = True\n allow_future = True\n示例 myapp/urls.py：
\nfrom django.urls import path\n\nfrom myapp.views import ArticleYearArchiveView\n\nurlpatterns = [\n path("<int:year>/", ArticleYearArchiveView.as_view(), name="article_year_archive"),\n]\n示例 myapp/article_archive_year.html：
\n<ul>\n {% for date in date_list %}\n <li>{{ date|date }}</li>\n {% endfor %}\n</ul>\n\n<div>\n <h1>All Articles for {{ year|date:"Y" }}</h1>\n {% for obj in object_list %}\n <p>\n {{ obj.title }} - {{ obj.pub_date|date:"F j, Y" }}\n </p>\n {% endfor %}\n</div>\nMonthArchiveViewLink to this heading#每月的存档页，显示特定月份的所有对象。除非你把 allow_future 设置为 True，否则不显示日期在 未来 的对象。
祖先（MRO）
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
上下文
\n除了 MultipleObjectMixin （通过 BaseDateListView）提供的上下文外，模板的上下文将是：
date_list：一个 QuerySet 对象，根据 queryset，以 datetime.datetime 对象的形式表示，按升序排列，包含给定月份内有对象可用的所有日子。
month：一个 date 对象，代表指定月份。
next_month： 一个 date 对象，根据 allow_empty 和 allow_future，表示下个月的第一天。
previous_month： 一个 date 对象，根据 allow_empty 和 allow_future，表示前一个月的第一天。
注意
\n使用默认为 _archive_month 的 template_name_suffix。
示例 myapp/views.py：
\nfrom django.views.generic.dates import MonthArchiveView\n\nfrom myapp.models import Article\n\n\nclass ArticleMonthArchiveView(MonthArchiveView):\n queryset = Article.objects.all()\n date_field = "pub_date"\n allow_future = True\n示例 myapp/urls.py：
\nfrom django.urls import path\n\nfrom myapp.views import ArticleMonthArchiveView\n\nurlpatterns = [\n # Example: /2012/08/\n path(\n "<int:year>/<int:month>/",\n ArticleMonthArchiveView.as_view(month_format="%m"),\n name="archive_month_numeric",\n ),\n # Example: /2012/aug/\n path(\n "<int:year>/<str:month>/",\n ArticleMonthArchiveView.as_view(),\n name="archive_month",\n ),\n]\n示例 myapp/article_archive_month.html：
\n<ul>\n {% for article in object_list %}\n <li>{{ article.pub_date|date:"F j, Y" }}: {{ article.title }}</li>\n {% endfor %}\n</ul>\n\n<p>\n {% if previous_month %}\n Previous Month: {{ previous_month|date:"F Y" }}\n {% endif %}\n {% if next_month %}\n Next Month: {{ next_month|date:"F Y" }}\n {% endif %}\n</p>\nWeekArchiveViewLink to this heading#每周的档案页，显示某一周的所有对象。除非你将 allow_future 设置为 True，否则不显示日期在 未来 的对象。
祖先（MRO）
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
上下文
\n除了 MultipleObjectMixin （通过 BaseDateListView）提供的上下文外，模板的上下文将是：
week：一个 date 对象，表示指定星期的第一天。
next_week：一个 date 对象，根据 allow_empty 和 allow_future，表示下周的第一天。
previous_week：一个 date 对象，根据 allow_empty 和 allow_future，表示前一周的第一天。
注意
\n使用默认为 _archive_week 的 template_name_suffix。
week_format 属性是一个 strptime() 格式字符串，用于解析星期数。支持的值如下：
'%U'：根据美国的周制，一周从周日开始。这是默认值。
'%W'：与 '%U' 类似，但它假定一周从星期一开始。这与 ISO 8601 周号不同。
'%V' ： ISO 8601 周号，即一周开始于星期一。
示例 myapp/views.py：
\nfrom django.views.generic.dates import WeekArchiveView\n\nfrom myapp.models import Article\n\n\nclass ArticleWeekArchiveView(WeekArchiveView):\n queryset = Article.objects.all()\n date_field = "pub_date"\n week_format = "%W"\n allow_future = True\n示例 myapp/urls.py：
\nfrom django.urls import path\n\nfrom myapp.views import ArticleWeekArchiveView\n\nurlpatterns = [\n # Example: /2012/week/23/\n path(\n "<int:year>/week/<int:week>/",\n ArticleWeekArchiveView.as_view(),\n name="archive_week",\n ),\n]\n示例 myapp/article_archive_week.html：
\n<h1>Week {{ week|date:'W' }}</h1>\n\n<ul>\n {% for article in object_list %}\n <li>{{ article.pub_date|date:"F j, Y" }}: {{ article.title }}</li>\n {% endfor %}\n</ul>\n\n<p>\n {% if previous_week %}\n Previous Week: {{ previous_week|date:"W" }} of year {{ previous_week|date:"Y" }}\n {% endif %}\n {% if previous_week and next_week %}--{% endif %}\n {% if next_week %}\n Next week: {{ next_week|date:"W" }} of year {{ next_week|date:"Y" }}\n {% endif %}\n</p>\n在这个例子中，你输出的是周数。请记住，由 date 模板过滤器用 '`W'` 格式字符计算的星期数与 strftime() 和 strptime() 用 '%W' 格式字符串计算的星期数并不总是相同的。例如，对于 2015 年， date 输出的周数比 strftime() 输出的周数高 1。date 中的 '%U' strftime() 格式字符串没有等价物。因此，你应该避免使用 date 为 WeekArchiveView 生成 URL。
DayArchiveViewLink to this heading#一个显示某一天所有对象的日存档页面。未来的日子会抛出 404 错误，不管未来的日子是否有任何对象存在，除非你把 allow_future 设置为 True。
祖先（MRO）
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
上下文
\n除了 MultipleObjectMixin （通过 BaseDateListView）提供的上下文外，模板的上下文将是：
day：一个 date 对象，代表指定的一天。
next_day：一个 date 对象，根据 allow_empty 和 allow_future 表示第二天。
previous_day：一个 date 对象，根据 allow_empty 和 allow_future 表示前一天。
next_month： 一个 date 对象，根据 allow_empty 和 allow_future，表示下个月的第一天。
previous_month： 一个 date 对象，根据 allow_empty 和 allow_future，表示前一个月的第一天。
注意
\n使用默认为 _archive_day 的 template_name_suffix。
示例 myapp/views.py：
\nfrom django.views.generic.dates import DayArchiveView\n\nfrom myapp.models import Article\n\n\nclass ArticleDayArchiveView(DayArchiveView):\n queryset = Article.objects.all()\n date_field = "pub_date"\n allow_future = True\n示例 myapp/urls.py：
\nfrom django.urls import path\n\nfrom myapp.views import ArticleDayArchiveView\n\nurlpatterns = [\n # Example: /2012/nov/10/\n path(\n "<int:year>/<str:month>/<int:day>/",\n ArticleDayArchiveView.as_view(),\n name="archive_day",\n ),\n]\n示例 myapp/article_archive_day.html：
\n<h1>{{ day }}</h1>\n\n<ul>\n {% for article in object_list %}\n <li>{{ article.pub_date|date:"F j, Y" }}: {{ article.title }}</li>\n {% endfor %}\n</ul>\n\n<p>\n {% if previous_day %}\n Previous Day: {{ previous_day }}\n {% endif %}\n {% if previous_day and next_day %}--{% endif %}\n {% if next_day %}\n Next Day: {{ next_day }}\n {% endif %}\n</p>\nTodayArchiveViewLink to this heading#一个显示 今天 所有对象的日存档页面。这和 django.views.generic.dates.DayArchiveView 完全一样，只是用今天的日期代替 year／month／day 参数。
祖先（MRO）
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
注意
\n使用默认为 _archive_today 的 template_name_suffix。
示例 myapp/views.py：
\nfrom django.views.generic.dates import TodayArchiveView\n\nfrom myapp.models import Article\n\n\nclass ArticleTodayArchiveView(TodayArchiveView):\n queryset = Article.objects.all()\n date_field = "pub_date"\n allow_future = True\n示例 myapp/urls.py：
\nfrom django.urls import path\n\nfrom myapp.views import ArticleTodayArchiveView\n\nurlpatterns = [\n path("today/", ArticleTodayArchiveView.as_view(), name="archive_today"),\n]\nDateDetailViewLink to this heading#一个页面代表一个单独的对象。如果对象有一个未来的日期值，除非你把 allow_future 设置为 True，否则视图会默认抛出 404 错误。
祖先（MRO）
\ndjango.views.generic.detail.SingleObjectTemplateResponseMixin
上下文
\n包括与 DateDetailView 中指定的 model 相关的单个对象。
注意
\n使用默认为 _detail 的 template_name_suffix。
示例 myapp/urls.py：
\nfrom django.urls import path\nfrom django.views.generic.dates import DateDetailView\n\nurlpatterns = [\n path(\n "<int:year>/<str:month>/<int:day>/<int:pk>/",\n DateDetailView.as_view(model=Article, date_field="pub_date"),\n name="archive_date_detail",\n ),\n]\n示例 myapp/article_detail.html：
\n<h1>{{ object.title }}</h1>\n