Les vues génériques basées sur les dates, définies dans django.views.generic.dates, sont des vues destinées à afficher des pages énumérant en détails des données en fonction de leur date.
ArchiveIndexViewLien vers cette rubrique#Une page de sommaire de premier niveau affichant les « derniers » objets par date. Les objets ayant une date dans le futur ne sont pas inclus, sauf si allow_future est défini à True.
Ancêtres (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Contexte
\nEn plus du contexte fourni par django.views.generic.list.MultipleObjectMixin (via django.views.generic.dates.BaseDateListView), le contexte de gabarit sera :
date_list: un objet QuerySet contenant toutes les années possédant des objets disponibles en fonction de queryset, représentés sous forme d’objets datetime.datetime dans l’ordre chronologique inverse.
Notes
\nLa valeur par défaut de context_object_name est latest.
La valeur par défaut de template_name_suffix est _archive.
Le comportement par défaut est de fournir date_list par année, mais il est possible aussi d’utiliser des mois ou des jours en modifiant l’attribut date_list_period. Cela s’applique également à toutes les sous-classes de cette vue.
Exemple 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]\nExemple de myapp/article_archive.html:
\n<ul>\n {% for article in latest %}\n <li>{{ article.pub_date }}: {{ article.title }}</li>\n {% endfor %}\n</ul>\nCeci affiche tous les articles.
\nYearArchiveViewLien vers cette rubrique#Une page d’archives annuelles affichant tous les mois disponibles d’une année donnée. Les objets ayant une date dans le futur ne sont pas inclus, sauf si allow_future est défini à True.
Ancêtres (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Un booléen indiquant s’il faut récupérer la liste complète des objets de l’année courante et les passer au gabarit. Si la valeur est à True, la liste sera disponible dans le contexte. Sinon, si la valeur est à False, le jeu de requête None sera utilisé en tant que liste d’objets. Par défaut, cette valeur vaut False.
Détermine si une liste d’objets est renvoyée comme une portion du contexte. Renvoie make_object_list par défaut.
Contexte
\nEn plus du contexte fourni par django.views.generic.list.MultipleObjectMixin (via django.views.generic.dates.BaseDateListView), le contexte de gabarit sera :
date_list: un objet QuerySet contenant tous les mois possédant des objets disponibles en fonction de queryset, représentés sous forme d’objets datetime.datetime dans l’ordre chronologique.
year: un objet date représentant l’année indiquée.
next_year: un objet date représentant le premier jour de l’année suivante, en fonction de allow_empty et allow_future.
previous_year: un objet date représentant le premier jour de l’année précédente, en fonction de allow_empty et allow_future.
Notes
\nLa valeur par défaut de template_name_suffix est _archive_year.
Exemple 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\nExemple 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]\nExemple 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>\nMonthArchiveViewLien vers cette rubrique#Une page d’archives mensuelles affichant tous les objets disponibles d’un mois donné. Les objets ayant une date dans le futur ne sont pas inclus, sauf si allow_future est défini à True.
Ancêtres (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Contexte
\nEn plus du contexte fourni par la classe MultipleObjectMixin (via BaseDateListView), le contexte du gabarit sera :
date_list: un objet QuerySet contenant tous les jours possédant des objets disponibles dans le mois indiqué, en fonction de queryset, représentés sous forme d’objets datetime.datetime dans l’ordre chronologique.
month: un objet date représentant le mois donné.
next_month: un objet date représentant le premier jour du mois suivant, en fonction de allow_empty et allow_future.
previous_month: un objet date représentant le premier jour du mois précédent, en fonction de allow_empty et allow_future.
Notes
\nLa valeur par défaut de template_name_suffix est _archive_month.
Exemple 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\nExemple 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]\nExemple 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>\nWeekArchiveViewLien vers cette rubrique#Une page d’archives hebdomadaires affichant tous les objets disponibles d’une semaine donnée. Les objets ayant une date dans le futur ne sont pas inclus, sauf si allow_future est défini à True.
Ancêtres (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Contexte
\nEn plus du contexte fourni par la classe MultipleObjectMixin (via BaseDateListView), le contexte du gabarit sera :
week: un objet date représentant le premier jour de la semaine indiquée.
next_week: un objet date représentant le premier jour de la semaine suivante, en fonction de allow_empty et allow_future.
previous_week: un objet date représentant le premier jour de la semaine précédente, en fonction de allow_empty et allow_future.
Notes
\nLa valeur par défaut de template_name_suffix est _archive_week.
L’attribut week_format est une chaîne de format strptime() utilisée pour récupérer le numéro de semaine. Les valeurs suivantes sont prises en charge :
'%U' : basé sur le système de semaines des États-Unis où la semaine commence un dimanche. Il s’agit de la valeur par défaut.
'%W' : semblable à '%U', excepté la semaine qui commence par le lundi. Ce n’est pas la même chose que le numéro de semaine ISO 8601.
'%V': le numéro de semaine ISO 8601 où la semaine commence un lundi.
Exemple 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\nExemple 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]\nExemple 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>\nDans cet exemple, le numéro de semaine est affiché. N’oubliez pas que les numéros de semaine produits par le filtre de gabarit date avec le caractère de mise en forme 'W' ne sont pas toujours identiques aux numéros de semaine produits par la chaîne de mise en forme '%W' de strftime() et strptime(). Par exemple, pour l’année 2015, les numéros de semaine produits par date sont plus élevés de un par rapport à ceux de strftime(). Il n’existe pas d’équivalent à la chaîne de format '%U' de strftime() pour date. Il faudrait donc éviter d’utiliser date pour générer des URL pour la vue WeekArchiveView.
DayArchiveViewLien vers cette rubrique#Une page d’archives journalières affichant tous les objets disponibles d’un jour donné. Les jours ayant une date dans le futur génèrent une erreur 404, sans considérer si des objets existent pour les jours futurs, sauf si allow_future est défini à True.
Ancêtres (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Contexte
\nEn plus du contexte fourni par la classe MultipleObjectMixin (via BaseDateListView), le contexte du gabarit sera :
day: un objet date représentant le jour indiqué.
next_day: un objet date représentant le jour suivant, en fonction de allow_empty et allow_future.
previous_day: un objet date représentant le jour précédent, en fonction de allow_empty et allow_future.
next_month: un objet date représentant le premier jour du mois suivant, en fonction de allow_empty et allow_future.
previous_month: un objet date représentant le premier jour du mois précédent, en fonction de allow_empty et allow_future.
Notes
\nLa valeur par défaut de template_name_suffix est _archive_day.
Exemple 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\nExemple 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]\nExemple 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>\nTodayArchiveViewLien vers cette rubrique#Une page d’archives journalières affichant tous les objets disponibles pour aujourd’hui. C’est exactement la même vue que django.views.generic.dates.DayArchiveView, excepté que c’est la date du jour qui est prise en compte à la place des paramètres year/month/day.
Ancêtres (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Notes
\nLa valeur par défaut de template_name_suffix est _archive_today.
Exemple 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\nExemple 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]\nDateDetailViewLien vers cette rubrique#Une page représentant un objet individuel. Si l’objet contient une valeur de date dans le futur, la vue génère par défaut une erreur 404, sauf si allow_future est défini à True.
Ancêtres (MRO)
\ndjango.views.generic.detail.SingleObjectTemplateResponseMixin
Contexte
\nInclut l’objet unique associé au model défini dans la vue DateDetailView.
Notes
\nLa valeur par défaut de template_name_suffix est _detail.
Exemple 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]\nExemple myapp/article_detail.html :
\n<h1>{{ object.title }}</h1>\n