Python Django WeekArchiveView用法及代碼示例

本文介紹 django.views.generic.dates.WeekArchiveView 的用法。

聲明

class WeekArchiveView

每周存檔頁麵，顯示給定一周內的所有對象。除非您將 allow_future 設置為 True ，否則不會顯示日期在 future 中的對象。

祖先 (MRO)

語境

除了 MultipleObjectMixin (通過 BaseDateListView )提供的上下文之外，模板的上下文將是：

week ：一個 date 對象，表示給定一周的第一天。
next_week ：根據 allow_empty 和 allow_future 表示下一周的第一天的 date 對象。
previous_week ：根據 allow_empty 和 allow_future 表示前一周的第一天的 date 對象。

注意

使用 _archive_week 的默認 template_name_suffix 。
week_format 屬性是用於解析周數的 strptime() 格式字符串。支持以下值：
- '%U' ：基於每周從星期日開始的美國周係統。這是默認值。
- '%W' ：類似於 '%U' ，但它假定一周從星期一開始。這與 ISO 8601 周數不同。
- '%V' ：ISO 8601 周數，該周從星期一開始。
  
  Django 3.2 中的新函數：
  添加了對'%V' 周格式的支持。

示例 myapp/views.py：

from django.views.generic.dates import WeekArchiveView

from myapp.models import Article

class ArticleWeekArchiveView(WeekArchiveView):
    queryset = Article.objects.all()
    date_field = "pub_date"
    week_format = "%W"
    allow_future = True

示例 myapp/urls.py：

from django.urls import path

from myapp.views import ArticleWeekArchiveView

urlpatterns = [
    # Example: /2012/week/23/
    path('<int:year>/week/<int:week>/',
         ArticleWeekArchiveView.as_view(),
         name="archive_week"),
]

示例 myapp/article_archive_week.html：

<h1>Week {{ week|date:'W' }}</h1>

<ul>
    {% for article in object_list %}
        <li>{{ article.pub_date|date:"F j, Y" }}: {{ article.title }}</li>
    {% endfor %}
</ul>

<p>
    {% if previous_week %}
        Previous Week: {{ previous_week|date:"W" }} of year {{ previous_week|date:"Y" }}
    {% endif %}
    {% if previous_week and next_week %}--{% endif %}
    {% if next_week %}
        Next week: {{ next_week|date:"W" }} of year {{ next_week|date:"Y" }}
    {% endif %}
</p>

在此示例中，您將輸出周數。請記住，使用'W' 格式字符的 date 模板過濾器計算的周數並不總是與使用'%W' 格式字符串的 strftime() 和 strptime() 計算的相同。例如，對於 2015 年， date 輸出的周數比 strftime() 輸出的周數高 1。 date 中的 '%U' strftime() 格式字符串沒有等效項。因此，您應該避免使用 date 為 WeekArchiveView 生成 URL。

相關用法

注：本文由純淨天空篩選整理自djangoproject.com大神的英文原創作品 django.views.generic.dates.WeekArchiveView。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。