日付ベースのジェネリックビュー (django.views.generic.dates 内で提供されています) は、日付ベースのデータのために、ドリルダウンページを描画するためのビューです。
ArchiveIndexViewLink to this heading#"最新の"オブジェクトを、日付によって表示するトップレベルのインデックスページです。allow_future を True にセットしない限り、未来 の日付のオブジェクトは含まれません。
継承元 (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
コンテキスト
\n(django.views.generic.dates.BaseDateListView を通じた) django.views.generic.list.MultipleObjectMixin によって提供されたコンテキストに加えて、テンプレートのコンテキストは以下のようになります:
date_list: queryset に従ってオブジェクトを利用可能にするすべての年を含む QuerySet オブジェクトです。datetime.datetime オブジェクトとして表され、降順で表示されます。
ノート
\nデフォルトの 最新 の context_object_name を使います。
デフォルトの _archive の template_name_suffix を使います。
年によって date_list を提供する動作がデフォルトですが、date_list_period 属性を用いた月や日に変更できます。これは、すべてのサブクラスのビューに適用されます。
例 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]\n例 myapp/article_archive.html:
\n<ul>\n {% for article in latest %}\n <li>{{ article.pub_date }}: {{ article.title }}</li>\n {% endfor %}\n</ul>\nこれは、すべての記事 (article) を出力します。
\nYearArchiveViewLink to this heading#与えられた年の中で有効な月を表示する、年次のアーカイブページです。allow_future を True にセットしない限り、未来 の日付を伴うオブジェクトは表示されません。
継承元 (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
この年のオブジェクトの全リストを取得し、テンプレートに渡すかどうかを指定する真偽値。もし True なら、オブジェクトのリストがコンテキストで利用可能になります。 False の場合、オブジェクトリストとして None クエリセットが使用されます。デフォルトでは False です。
オブジェクトリストをコンテキストの一部として返すかどうかを決定します。デフォルトでは make_object_list を返します。
コンテキスト
\n(django.views.generic.dates.BaseDateListView を通じた) django.views.generic.list.MultipleObjectMixin によって提供されたコンテキストに加えて、テンプレートのコンテキストは以下のようになります:
date_list: QuerySet オブジェクトで、 datetime.datetime オブジェクトとして昇順に表現された、 queryset に従って利用可能なオブジェクトを持つ全ての月を含みます。
year: 与えられた年を表す date オブジェクト。
next_year: allow_empty と allow_future に従って、次の年の最初の日を表す date オブジェクト。
previous_year: date オブジェクト。 allow_empty と allow_future に従います。
ノート
\nデフォルトの template_name_suffix は _archive_year です。
例 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\n例 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]\n例 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#与えられた月の中で有効な全オブジェクトを表示する、月次のアーカイブページです。allow_future を True にセットしない限り、未来 の日付を伴うオブジェクトは表示されません。
継承元 (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
コンテキスト
\nMultipleObjectMixin (BaseDateListView 経由) によって提供されるコンテキストに加えて、テンプレートのコンテキストも提供されます：
date_list: QuerySet オブジェクトで、 queryset に従って、与えられた月にオブジェクトが利用可能な全ての日を、 datetime.datetime オブジェクトとして昇順で表します。
month: 与えられた月を表す date オブジェクト。
next_month: allow_empty と allow_future に従って、次の月の最初の日を表す date オブジェクト。
previous_month: allow_empty と allow_future に従って、前月の最初の日を表す date オブジェクト。
ノート
\nデフォルトの template_name_suffix は _archive_month です。
例 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\n例 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]\n例 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#与えられた週の中で有効な全オブジェクトを表示する、週次のアーカイブページです。allow_future を True にセットしない限り、未来 の日付を伴うオブジェクトは表示されません。
継承元 (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
コンテキスト
\nMultipleObjectMixin (BaseDateListView 経由) によって提供されるコンテキストに加えて、テンプレートのコンテキストも提供されます：
week: 指定した週の最初の日を表す date オブジェクト。
next_week: allow_empty と allow_future に従って、次の週の最初の日を表す date オブジェクト。
previous_week: allow_empty と allow_future に従って、前の週の最初の日を表す date オブジェクト。
ノート
\nデフォルトの template_name_suffix は _archive_week です。
week_format 属性は strptime() フォーマット文字列で、週番号をパースするために使用されます。以下の値がサポートされています：
'%U': 日曜日が週の始まりとなるアメリカ合衆国の週システムに基づきます。これはデフォルト値です。
'%W': '%U' と似ていますが、週が月曜日から始まると仮定している点が異なります。これはISO 8601の週番号とは異なります。
'%V': 週が月曜日から始まるISO 8601の週番号。
例 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\n例 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]\n例 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>\nこの例では週番号を出力しています。 テンプレートフィルタの date が 'W' フォーマット文字列で計算した週番号は、 strftime() や strptime() が '%W' フォーマット文字列で計算した週番号と必ずしも同じではないことに注意してください。例えば2015年の場合、 date が出力する週番号は strftime() が出力する週番号よりも1つ大きくなります。date には '%U' strftime() の書式文字列と等価なものはありません。そのため、 date を使って WeekArchiveView の URL を生成することは避けるべきです。
DayArchiveViewLink to this heading#与えられた日の中で有効な全オブジェクトを表示する、日次のアーカイブページです。allow_future を True にセットしない限り、未来の日付に対するオブジェクトがするかどうかにかかわらず、未来の日付は 404 エラーを返します。
継承元 (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
コンテキスト
\nMultipleObjectMixin (BaseDateListView 経由) によって提供されるコンテキストに加えて、テンプレートのコンテキストも提供されます：
day: 指定した日を表す date オブジェクト。
next_day: allow_empty と allow_future に従って、次の日を表す date オブジェクト。
previous_day: allow_empty と allow_future に従って、前日を表す date オブジェクト。
next_month: allow_empty と allow_future に従って、次の月の最初の日を表す date オブジェクト。
previous_month: allow_empty と allow_future に従って、前月の最初の日を表す date オブジェクト。
ノート
\nデフォルトの template_name_suffix は _archive_day です。
例 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\n例 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]\n例 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#今日 の全てのオブジェクトを表示する、日時のアーカイブページです。年 / 月 / 日 引数の代わりに今日の日付が使われること以外は、django.views.generic.dates.DayArchiveView とまったく同じです。
継承元 (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
ノート
\nデフォルトの template_name_suffix は _archive_today です。
例 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\n例 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#個別のオブジェクトを表示するページです。オブジェクトが未来の日付値を持っている場合、allow_future を True にセットしない限り、デフォルトでビューは 404 エラーを返します。
継承元 (MRO)
\ndjango.views.generic.detail.SingleObjectTemplateResponseMixin
コンテキスト
\nDateDetailView で指定された model に関連付けられたオブジェクトを1つだけ含みます。
ノート
\nデフォルトの template_name_suffix は _detail です。
例 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]\n例 myapp/article_detail.html:
\n<h1>{{ object.title }}</h1>\n