“Views” genéricas baseadas em datas, fornecidas no django.views.generic.dates, são “views” para mostrar páginas de resumo de dados baseados em datas.
ArchiveIndexViewLink para este cabeçalho#Uma página de índice de n;ível superior que mostra os últimos (“latest”) objetos, por data. Objetos com uma data no futuro não estão incluídos a menos que seja definido allow_future como True.
Ancestrais (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Context
\nAlém do contexto fornecido pelo django.views.generic.list.MultipleObjectMixin (através da django.views.generic.dates.BaseDateListView), o contexto do template será:
date_list: Um objeto QuerySet contendo todos os anos que tenham objetos disponíveis de acordo com o queryset, representado como objetos datetime.datetime, em ordem ascendente.
Notas
\nUsa um context_object_name padrão como latest.
Usa um template_name_suffix padrão como _archive.
Por padrão fornece date_list por ano, mas isso pode ser alterado para mês ou dia usando o atributo date_list_period. Isso se aplica a todas as subclasses de “views”.
Exemplo myapp/urls.py:
\nfrom django.conf.urls import url\nfrom django.views.generic.dates import ArchiveIndexView\n\nfrom myapp.models import Article\n\nurlpatterns = [\n url(r'^archive/$',\n ArchiveIndexView.as_view(model=Article, date_field="pub_date"),\n name="article_archive"),\n]\nExemplo myapp/article_archive.html:
\n<ul>\n {% for article in latest %}\n <li>{{ article.pub_date }}: {{ article.title }}</li>\n {% endfor %}\n</ul>\nIsso irá retornar todos os artigos.
\nYearArchiveViewLink para este cabeçalho#Uma página de arquivos anuais mostrando todos os meses disponíveis em um dado ano. Objetos com uma data no futuro não são mostrados a menos que defina allow_future como True.
Ancestrais (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Um booleano que especifica se retorna ou não a lista toda de objetos para este ano e os passa para o template. Se True, a lista de objetos será disponibilizada no contexto. Se False, o “queryset” None será usado como a lista de objetos. Por padrão isso é False.
Determina se uma lista de objetos será retonado como parte do contexto. Retorna make_object_list por padrão.
Context
\nAlém do contexto fornecido pelo django.views.generic.list.MultipleObjectMixin (através da django.views.generic.dates.BaseDateListView), o contexto do template será:
date_list: Um objeto QuerySet contendo todos os meses que tenham objetos disponíveis de acordo com o queryset, representado como objetos datetime.datetime em order ascendente.
year: Um objeto date representando um dado ano.
next_year: Um objeto do tipo date representando o primeiro dia do próximo ano, de acordo com allow_empty e allow_future.
previous_year: Um objeto date representando o primeiro dia do ano anterior, de acordo com allow_empty e allow_future.
Notas
\nUsa um template_name_suffix padrão como _archive_year.
Exemplo myapp/views.py:
\nfrom django.views.generic.dates import YearArchiveView\n\nfrom myapp.models import Article\n\nclass ArticleYearArchiveView(YearArchiveView):\n queryset = Article.objects.all()\n date_field = "pub_date"\n make_object_list = True\n allow_future = True\nExemplo myapp/urls.py:
\nfrom django.conf.urls import url\n\nfrom myapp.views import ArticleYearArchiveView\n\nurlpatterns = [\n url(r'^(?P<year>[0-9]{4})/$',\n ArticleYearArchiveView.as_view(),\n name="article_year_archive"),\n]\nExemplo 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 para este cabeçalho#Uma página de arquivo mensal mostrando todos os objetos em um dado mês. Objetos com uma data no futuro não são mostrados a menos que defina allow_future como True.
Ancestrais (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Context
\nAlém do contexto fornecido pela MultipleObjectMixin (via BaseDateListView), o contexto do template será:
date_list: Um objeto do tipo QuerySet contendo todo os dias que tenham objetos disponíveis no dado mês, de cordo com o queryset, representando como objetos do tipo datetime.datetime , em orderm ascendente.
month: Um objeto do tipo date representando o dado mês.
next_month: Um objeto date que representa o primeiro dia do próximo mês, de acordo com allow_empty e allow_future.
previous_month: Um objeto date que representa o primeiro dia do mês anterior, de acordo com allow_empty e allow_future.
Notas
\nUsa um template_name_suffix padrão como _archive_month.
Exemplo myapp/views.py:
\nfrom django.views.generic.dates import MonthArchiveView\n\nfrom myapp.models import Article\n\nclass ArticleMonthArchiveView(MonthArchiveView):\n queryset = Article.objects.all()\n date_field = "pub_date"\n allow_future = True\nExemplo myapp/urls.py:
\nfrom django.conf.urls import url\n\nfrom myapp.views import ArticleMonthArchiveView\n\nurlpatterns = [\n # Example: /2012/aug/\n url(r'^(?P<year>[0-9]{4})/(?P<month>[-\\w]+)/$',\n ArticleMonthArchiveView.as_view(),\n name="archive_month"),\n # Example: /2012/08/\n url(r'^(?P<year>[0-9]{4})/(?P<month>[0-9]+)/$',\n ArticleMonthArchiveView.as_view(month_format='%m'),\n name="archive_month_numeric"),\n]\nExemplo 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 para este cabeçalho#Uma página de arquivo semanal mostrando todos os objetos em determinada semana. Objetos com uma data no futuro não são exibidos a menos que você defina allow_future como True.
Ancestrais (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Context
\nAlém do contexto fornecido pela MultipleObjectMixin (via BaseDateListView), o contexto do template será:
week: Um objeto date que representa o primeiro dia de uma dada semana.
next_week: Um objeto do tipo date representando o primeiro dia da próxima semana, de acordo com allow_empty e allow_future.
previous_week: Um objeto date representando o primeiro dia da semana anterior, de acordo com allow_empty e allow_future.
Notas
\nUsa um template_name_suffix padrão como _archive_week.
O atributo week_format é uma string de formtação do tipo strptime() usada para formatar o número da semana. Os seguintes valores são permitidos:
'%U': Baseado no sistema de semanas do Estados Unidos onde a semana começa no Domingo. Este é o valor padrão.
'%W': Similar to '%U', except it assumes that the week\nbegins on Monday. This is not the same as the ISO 8601 week number.
Exemplo myapp/views.py:
\nfrom django.views.generic.dates import WeekArchiveView\n\nfrom myapp.models import Article\n\nclass ArticleWeekArchiveView(WeekArchiveView):\n queryset = Article.objects.all()\n date_field = "pub_date"\n week_format = "%W"\n allow_future = True\nExemplo myapp/urls.py:
\nfrom django.conf.urls import url\n\nfrom myapp.views import ArticleWeekArchiveView\n\nurlpatterns = [\n # Example: /2012/week/23/\n url(r'^(?P<year>[0-9]{4})/week/(?P<week>[0-9]+)/$',\n ArticleWeekArchiveView.as_view(),\n name="archive_week"),\n]\nExemplo 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>\nNesse exemplo, você está exibindo o número da semana. Note que os números da semana computados pelo filtro de template date com o caractere 'W' não é extamente o mesmo que os computados pelo strftime() e strptime() com a string de formatação '%W'. No ano de 2015, por exemplo, a exibição dos números da semana pelo date são maiores que outras se comparadas com a saída pelo strftime(). Não há um equivalente para a string de formatação '%U' strftime(). Por tanto, você deve evitar o uso de date para gerar URLs para WeekArchiveView.
DayArchiveViewLink para este cabeçalho#Uma página de arquivo diária mostrando todos os objetos em determinado dia. Dias no futuro retornam erro 404, independente da existência de objetos com dias futuros, a menos que você defina allow_future como True.
Ancestrais (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Context
\nAlém do contexto fornecido pela MultipleObjectMixin (via BaseDateListView), o contexto do template será:
day: Um objeto date representando um dado dia.
next_day`: Um objeto do tipo date representando o próximo dia de acordo com allow_empty e allow_future.
previous_day: Um objeto do tipo date representando o dia anterior de acordo com allow_empty e allow_future.
next_month: Um objeto date que representa o primeiro dia do próximo mês, de acordo com allow_empty e allow_future.
previous_month: Um objeto date que representa o primeiro dia do mês anterior, de acordo com allow_empty e allow_future.
Notas
\nUsa um template_name_suffix padrão como _archive_day.
Exemplo myapp/views.py:
\nfrom django.views.generic.dates import DayArchiveView\n\nfrom myapp.models import Article\n\nclass ArticleDayArchiveView(DayArchiveView):\n queryset = Article.objects.all()\n date_field = "pub_date"\n allow_future = True\nExemplo myapp/urls.py:
\nfrom django.conf.urls import url\n\nfrom myapp.views import ArticleDayArchiveView\n\nurlpatterns = [\n # Example: /2012/nov/10/\n url(r'^(?P<year>[0-9]{4})/(?P<month>[-\\w]+)/(?P<day>[0-9]+)/$',\n ArticleDayArchiveView.as_view(),\n name="archive_day"),\n]\nExemplo 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 para este cabeçalho#Uma página de arquivo diária mostrando todos os objetos de “hoje”. Isso é exatamente o mesmo que django.views.generic.dates.DayArchiveView, exceto que a data de “hoje” é usada ao invés dos argumentos year/month/day
Ancestrais (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Notas
\nUsa um template_name_suffix padrão como _archive_today.
Exemplo myapp/views.py:
\nfrom django.views.generic.dates import TodayArchiveView\n\nfrom myapp.models import Article\n\nclass ArticleTodayArchiveView(TodayArchiveView):\n queryset = Article.objects.all()\n date_field = "pub_date"\n allow_future = True\nExemplo myapp/urls.py:
\nfrom django.conf.urls import url\n\nfrom myapp.views import ArticleTodayArchiveView\n\nurlpatterns = [\n url(r'^today/$',\n ArticleTodayArchiveView.as_view(),\n name="archive_today"),\n]\nDateDetailViewLink para este cabeçalho#Uma página representando um objeto individual. Se o objeto possui uma data no futuro, a view irá gerar um erro 404 por padrão, a menos que você defina allow_future como True.
Ancestrais (MRO)
\ndjango.views.generic.detail.SingleObjectTemplateResponseMixin
django.views.generic.detail.BaseDetailView
Context
\nInclui um único objeto associado ao model especificado em DateDetailView.
Notas
\nUsa um template_name_suffix padrão como _detail.
Exemplo myapp/urls.py:
\nfrom django.conf.urls import url\nfrom django.views.generic.dates import DateDetailView\n\nurlpatterns = [\n url(r'^(?P<year>[0-9]{4})/(?P<month>[-\\w]+)/(?P<day>[0-9]+)/(?P<pk>[0-9]+)/$',\n DateDetailView.as_view(model=Article, date_field="pub_date"),\n name="archive_date_detail"),\n]\nExemplo myapp/article_detail.html:
\n<h1>{{ object.title }}</h1>\n