通用日期视图

    注解

    本页的一些例子假定 Article 模型已在 myapp/models.py 中定义如下：

    class ArchiveIndexView

    一个按日期显示“最新”对象的顶层索引页。除非你将 allow_future 设置为 True，否则不包含日期在 未来 的对象。

    祖先（MRO）

    上下文

    除了 （通过 django.views.generic.dates.BaseDateListView）提供的上下文外，模板的上下文将是：

    • date_list：一个 对象，包含根据 queryset 有对象可用的所有年份，以 datetime.datetime 对象表示，按降序排列。

    注意

    • 使用默认为 latest 的 context_object_name。
    • 使用默认为 _archive 的 template_name_suffix。
    • 默认情况下，按年提供 date_list，但可以使用 date_list_period 属性将其改为月或日。这也适用于所有子类视图。

    示例 myapp/urls.py：

    1. from django.urls import path
    2. from django.views.generic.dates import ArchiveIndexView
    4. from myapp.models import Article
    6. urlpatterns = [
    7.     path('archive/',
    8.          ArchiveIndexView.as_view(model=Article, date_field="pub_date"),
    9.          name="article_archive"),
    10. ]

    示例 myapp/article_archive.html：

    1. <ul>
    2.     {% for article in latest %}
    3.         <li>{{ article.pub_date }}: {{ article.title }}</li>
    4.     {% endfor %}
    5. </ul>

    这将输出所有文章。

    YearArchiveView

    class YearArchiveView

    每年的存档页，显示某一年的所有可用月份。除非你把 allow_future 设置为 True，否则不显示日期在 未来 的对象。

    祖先（MRO）

    上下文

    除了 （通过 django.views.generic.dates.BaseDateListView）提供的上下文外，模板的上下文将是：

    • date_list。一个 对象，包含根据 queryset 有对象可用的所有月份，以 datetime.datetime 对象表示，按升序排列。
    • year：一个 对象，代表特定年份。
    • next_year： 一个:class:~datetime.date 对象，根据 allow_empty 和 ，表示下一年的第一天。
    • previous_year： 一个 date 对象，根据 和 allow_future，表示前一年的第一天。

    注意

    • 使用默认为 _archive_year 的 template_name_suffix。

    示例 myapp/views.py：

    1. from django.views.generic.dates import YearArchiveView
    3. from myapp.models import Article
    5. class ArticleYearArchiveView(YearArchiveView):
    6.     queryset = Article.objects.all()
    7.     date_field = "pub_date"
    8.     make_object_list = True
    9.     allow_future = True

    示例 myapp/urls.py：

    1. from django.urls import path
    3. from myapp.views import ArticleYearArchiveView
    5. urlpatterns = [
    6.     path('<int:year>/',
    7.          ArticleYearArchiveView.as_view(),
    8.          name="article_year_archive"),
    9. ]

    示例 myapp/article_archive_year.html：

    1. <ul>
    2.     {% for date in date_list %}
    3.         <li>{{ date|date }}</li>
    4.     {% endfor %}
    5. </ul>
    7. <div>
    8.     <h1>All Articles for {{ year|date:"Y" }}</h1>
    9.     {% for obj in object_list %}
    10.         <p>
    11.             {{ obj.title }} - {{ obj.pub_date|date:"F j, Y" }}
    12.         </p>
    13.     {% endfor %}
    14. </div>

    class MonthArchiveView

    每月的存档页，显示特定月份的所有对象。除非你把 allow_future 设置为 ，否则不显示日期在 未来 的对象。

    上下文

    除了 （通过 BaseDateListView）提供的上下文外，模板的上下文将是：

    • date_list：一个 对象，根据 queryset，以 datetime.datetime 对象的形式表示，按升序排列，包含给定月份内有对象可用的所有日子。
    • month：一个 对象，代表指定月份。
    • next_month： 一个 date 对象，根据 和 allow_future，表示下个月的第一天。
    • previous_month： 一个 对象，根据 allow_empty 和 ，表示前一个月的第一天。

    注意

    • 使用默认为 _archive_month 的 template_name_suffix。

    示例 myapp/views.py：

    示例 myapp/urls.py：

    1. from django.urls import path
    3. from myapp.views import ArticleMonthArchiveView
    5. urlpatterns = [
    6.     # Example: /2012/08/
    7.     path('<int:year>/<int:month>/',
    8.          ArticleMonthArchiveView.as_view(month_format='%m'),
    9.          name="archive_month_numeric"),
    10.     # Example: /2012/aug/
    11.     path('<int:year>/<str:month>/',
    12.          ArticleMonthArchiveView.as_view(),
    13.          name="archive_month"),
    14. ]

    示例 myapp/article_archive_month.html：

    1. <ul>
    2.     {% for article in object_list %}
    3.         <li>{{ article.pub_date|date:"F j, Y" }}: {{ article.title }}</li>
    4.     {% endfor %}
    5. </ul>
    7. <p>
    8.     {% if previous_month %}
    9.         Previous Month: {{ previous_month|date:"F Y" }}
    10.     {% endif %}
    11.     {% if next_month %}
    12.         Next Month: {{ next_month|date:"F Y" }}
    13.     {% endif %}
    14. </p>

    WeekArchiveView

    class WeekArchiveView

    每周的档案页，显示某一周的所有对象。除非你将 allow_future 设置为 True，否则不显示日期在 未来 的对象。

    祖先（MRO）

    上下文

    除了 MultipleObjectMixin （通过 ）提供的上下文外，模板的上下文将是：

    • week：一个 date 对象，表示指定星期的第一天。
    • next_week：一个 对象，根据 allow_empty 和 ，表示下周的第一天。
    • previous_week：一个 date 对象，根据 和 allow_future，表示前一周的第一天。

    注意

    • 使用默认为 _archive_week 的 template_name_suffix。

    • week_format 属性是一个 格式字符串，用于解析星期数。支持的值如下：

      • '%U'：根据美国的周制，一周从周日开始。这是默认值。

      • '%W'：与 '%U' 类似，但它假定一周从星期一开始。这与 ISO 8601 周号不同。

      • '%V' ： ISO 8601 周号，即一周开始于星期一。

        New in Django 3.2:

        增加了对 '%V' 周格式的支持。

    示例 myapp/views.py：

    1. from django.views.generic.dates import WeekArchiveView
    3. from myapp.models import Article
    5. class ArticleWeekArchiveView(WeekArchiveView):
    6.     queryset = Article.objects.all()
    7.     date_field = "pub_date"
    8.     week_format = "%W"
    9.     allow_future = True

    示例 myapp/urls.py：

    1. from django.urls import path
    3. from myapp.views import ArticleWeekArchiveView
    5. urlpatterns = [
    6.     # Example: /2012/week/23/
    7.     path('<int:year>/week/<int:week>/',
    8.          ArticleWeekArchiveView.as_view(),
    9.          name="archive_week"),
    10. ]

    示例 myapp/article_archive_week.html：

    1. <h1>Week {{ week|date:'W' }}</h1>
    3. <ul>
    4.     {% for article in object_list %}
    5.         <li>{{ article.pub_date|date:"F j, Y" }}: {{ article.title }}</li>
    6.     {% endfor %}
    7. </ul>
    9. <p>
    10.     {% if previous_week %}
    11.         Previous Week: {{ previous_week|date:"W" }} of year {{ previous_week|date:"Y" }}
    12.     {% endif %}
    13.     {% if previous_week and next_week %}--{% endif %}
    14.     {% if next_week %}
    15.         Next week: {{ next_week|date:"W" }} of year {{ next_week|date:"Y" }}
    16.     {% endif %}
    17. </p>

    在这个例子中，你输出的是周数。请记住，由 date 模板过滤器用 ‘`W’` 格式字符计算的星期数与 和 strptime() 用 '%W' 格式字符串计算的星期数并不总是相同的。例如，对于 2015 年， 输出的周数比 strftime() 输出的周数高 1。 中的 strftime() 格式字符串没有等价物。因此，你应该避免使用 为 WeekArchiveView 生成 URL。

    class DayArchiveView

    一个显示某一天所有对象的日存档页面。未来的日子会抛出 404 错误，不管未来的日子是否有任何对象存在，除非你把 allow_future 设置为 True。

    祖先（MRO）

    上下文

    • day：一个 对象，代表指定的一天。
    • next_day：一个 date 对象，根据 和 allow_future 表示第二天。
    • previous_day：一个 对象，根据 allow_empty 和 表示前一天。
    • next_month： 一个 date 对象，根据 和 allow_future，表示下个月的第一天。
    • previous_month： 一个 对象，根据 allow_empty 和 ，表示前一个月的第一天。

    注意

    • 使用默认为 _archive_day 的 template_name_suffix。

    示例 myapp/views.py：

    示例 myapp/urls.py：

    1. from django.urls import path
    3. from myapp.views import ArticleDayArchiveView
    5. urlpatterns = [
    6.     # Example: /2012/nov/10/
    7.     path('<int:year>/<str:month>/<int:day>/',
    8.          ArticleDayArchiveView.as_view(),
    9.          name="archive_day"),
    10. ]

    示例 myapp/article_archive_day.html：

    1. <h1>{{ day }}</h1>
    3. <ul>
    4.     {% for article in object_list %}
    5.         <li>{{ article.pub_date|date:"F j, Y" }}: {{ article.title }}</li>
    6.     {% endfor %}
    7. </ul>
    9. <p>
    10.     {% if previous_day %}
    11.         Previous Day: {{ previous_day }}
    12.     {% endif %}
    13.     {% if previous_day and next_day %}--{% endif %}
    14.     {% if next_day %}
    15.         Next Day: {{ next_day }}
    16.     {% endif %}
    17. </p>

    TodayArchiveView

    class TodayArchiveView

    一个显示 今天 所有对象的日存档页面。这和 完全一样，只是用今天的日期代替 year／month／day 参数。

    祖先（MRO）

    注意

    • 使用默认为 _archive_today 的 template_name_suffix。

    示例 myapp/views.py：

    1. from django.views.generic.dates import TodayArchiveView
    3. from myapp.models import Article
    5. class ArticleTodayArchiveView(TodayArchiveView):
    6.     queryset = Article.objects.all()
    7.     date_field = "pub_date"
    8.     allow_future = True

    示例 myapp/urls.py：

    1. from django.urls import path
    3. from myapp.views import ArticleTodayArchiveView
    5. urlpatterns = [
    6.     path('today/',
    7.          ArticleTodayArchiveView.as_view(),
    8.          name="archive_today"),
    9. ]

    TodayArchiveView 的示例模板在哪里？

    该视图默认使用与前面例子中的 相同的模板。如果你需要一个不同的模板，请将 template_name 属性设置为新模板的名称。

    class DateDetailView

    一个页面代表一个单独的对象。如果对象有一个未来的日期值，除非你把 allow_future 设置为 True，否则视图会默认抛出 404 错误。

    祖先（MRO）

    上下文

    • 包括与 DateDetailView 中指定的 model 相关的单个对象。

    注意

    • 使用默认为 _detail 的 template_name_suffix。

    示例 myapp/urls.py：

    1. from django.urls import path
    2. from django.views.generic.dates import DateDetailView
    4. urlpatterns = [
    5.     path('<int:year>/<str:month>/<int:day>/<int:pk>/',
    6.          DateDetailView.as_view(model=Article, date_field="pub_date"),
    7.          name="archive_date_detail"),

    示例 myapp/article_detail.html：

    注解

    上面列出的所有通用视图都有匹配的 Base 视图，唯一不同的是它们不包括 MultipleObjectTemplateResponseMixin）用于存档视图）或 （用于 DateDetailView）。

    class BaseArchiveIndexView

    class BaseYearArchiveView

    class BaseMonthArchiveView

    class BaseWeekArchiveView

    class BaseDayArchiveView

    class