Datumbaserade generiska vyer, som tillhandahålls i django.views.generic.dates, är vyer för att visa drilldown-sidor för datumbaserade data.
ArchiveIndexViewLink to this heading#En indexsida på översta nivån som visar de ”senaste” objekten, efter datum. Objekt med ett datum i framtiden inkluderas inte om du inte ställer in allow_future till True.
Ancestors (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Kontext
\nFörutom det sammanhang som tillhandahålls av django.views.generic.list.MultipleObjectMixin (via django.views.generic.dates.BaseDateListView), kommer mallens sammanhang att vara:
date_list: Ett QuerySet-objekt som innehåller alla år som har objekt tillgängliga enligt queryset, representerade som datetime.datetime-objekt, i fallande ordning.
Noter
\nAnvänder ett standardnamn för context_object_name på latest.
Använder standardvärdet template_name_suffix för _archive.
Standard är att tillhandahålla date_list per år, men detta kan ändras till månad eller dag med hjälp av attributet date_list_period. Detta gäller även för alla underklassvyer.
Exempel 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]\nExempel myapp/article_archive.html:
\n<ul>\n {% for article in latest %}\n <li>{{ article.pub_date }}: {{ article.title }}</li>\n {% endfor %}\n</ul>\nDetta kommer att mata ut alla artiklar.
\nÅrArkivViewLink to this heading#En årlig arkivsida som visar alla tillgängliga månader under ett visst år. Objekt med ett datum i framtiden visas inte om du inte ställer in allow_future till True.
Ancestors (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
En boolean som anger om den fullständiga listan över objekt för det här året ska hämtas och skickas till mallen. Om True, kommer listan med objekt att göras tillgänglig för kontexten. Om False, kommer frågeuppsättningen None att användas som objektlista. Som standard är detta False.
Bestämmer om en objektlista ska returneras som en del av kontexten. Returnerar make_object_list som standard.
Kontext
\nFörutom det sammanhang som tillhandahålls av django.views.generic.list.MultipleObjectMixin (via django.views.generic.dates.BaseDateListView), kommer mallens sammanhang att vara:
date_list: Ett QuerySet-objekt som innehåller alla månader som har objekt tillgängliga enligt queryset, representerade som datetime.datetime-objekt, i stigande ordning.
year: Ett date-objekt som representerar det angivna året.
next_year: Ett date-objekt som representerar den första dagen i nästa år, enligt allow_empty och allow_future.
previous_year: Ett date-objekt som representerar den första dagen i det föregående året, enligt allow_empty och allow_future.
Noter
\nAnvänder standardvärdet för template_name_suffix _archive_year.
Exempel 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\nExempel 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]\nExempel 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#En månatlig arkivsida som visar alla objekt under en viss månad. Objekt med ett datum i framtiden visas inte om du inte har ställt in allow_future till True.
Ancestors (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Kontext
\nFörutom det sammanhang som tillhandahålls av MultipleObjectMixin (via BaseDateListView), kommer mallens sammanhang att vara:
datum_lista: Ett QuerySet-objekt som innehåller alla dagar som har objekt tillgängliga i den angivna månaden, enligt queryset, representerade som datetime.datetime-objekt, i stigande ordning.
month: Ett date-objekt som representerar den angivna månaden.
next_month: Ett date-objekt som representerar den första dagen i nästa månad, enligt allow_empty och allow_future.
previous_month: Ett date-objekt som representerar den första dagen i föregående månad, enligt allow_empty och allow_future.
Noter
\nAnvänder standardvärdet för template_name_suffix _archive_month.
Exempel 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\nExempel 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]\nExempel 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#En veckovis arkivsida som visar alla objekt under en viss vecka. Objekt med ett datum i framtiden visas inte om du inte har ställt in allow_future till True.
Ancestors (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Kontext
\nFörutom det sammanhang som tillhandahålls av MultipleObjectMixin (via BaseDateListView), kommer mallens sammanhang att vara:
week: Ett date-objekt som representerar den första dagen i den angivna veckan.
next_week: Ett date-objekt som representerar den första dagen i nästa vecka, enligt allow_empty och allow_future.
previous_week: Ett date-objekt som representerar den första dagen i föregående vecka, enligt allow_empty och allow_future.
Noter
\nAnvänder standardvärdet för template_name_suffix _archive_week.
Attributet week_format är en strptime() formatsträng som används för att tolka veckonumret. Följande värden stöds:
'%U': Baserat på USA:s veckosystem där veckan börjar på söndag. Detta är standardvärdet.
'%W': Liknar '%U', men antar att veckan börjar på måndag. Detta är inte samma sak som ISO 8601-veckonumret.
'%V': ISO 8601 veckonummer där veckan börjar på måndag.
Exempel 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\nExempel 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]\nExempel 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>\nI det här exemplet skriver du ut veckonumret. Tänk på att veckonummer som beräknas av mallfiltret date med formattecknet 'W' inte alltid är samma som de som beräknas av strftime() och strptime() med formatsträngen '%W'. För år 2015, till exempel, är veckonummer som matas ut av date högre med ett jämfört med de som matas ut av strftime(). Det finns ingen motsvarighet till formatsträngen '%U' strftime() i date. Därför bör du undvika att använda date för att generera URL:er för WeekArchiveView.
DayArchiveViewLink to this heading#En dagarkivsida som visar alla objekt under en viss dag. Dagar i framtiden ger ett 404-fel, oavsett om det finns några objekt för framtida dagar, såvida du inte har ställt in allow_future till True.
Ancestors (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Kontext
\nFörutom det sammanhang som tillhandahålls av MultipleObjectMixin (via BaseDateListView), kommer mallens sammanhang att vara:
day: Ett date-objekt som representerar den angivna dagen.
next_day: Ett date-objekt som representerar nästa dag, enligt allow_empty och allow_future.
previous_day: Ett date-objekt som representerar föregående dag, enligt allow_empty och allow_future.
next_month: Ett date-objekt som representerar den första dagen i nästa månad, enligt allow_empty och allow_future.
previous_month: Ett date-objekt som representerar den första dagen i föregående månad, enligt allow_empty och allow_future.
Noter
\nAnvänder standardvärdet för template_name_suffix _archive_day.
Exempel 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\nExempel 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]\nExempel 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#En dagarkivsida som visar alla objekt för today. Detta är exakt samma sak som django.views.generic.dates.DayArchiveView, förutom att dagens datum används istället för argumenten år/månad/dag.
Ancestors (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Noter
\nAnvänder standardvärdet template_name_suffix _archive_today.
Exempel 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\nExempel 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#En sida som representerar ett enskilt objekt. Om objektet har ett datumvärde i framtiden kommer vyn att ge ett 404-fel som standard, såvida du inte ställer in allow_future till True.
Ancestors (MRO)
\ndjango.views.generic.detail.SingleObjectTemplateResponseMixin
Kontext
\nInnehåller det enskilda objekt som är associerat med den modell som anges i DateDetailView.
Noter
\nAnvänder standardvärdet template_name_suffix för _detail.
Exempel 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]\nExempel myapp/article_detail.html:
\n<h1>{{ object.title }}</h1>\n