{"title":"ジェネリック日付ビュー","version":"5.1","locale":"ja","docname":"ref/class-based-views/generic-date-based","url":"/ja/5.1/ref/class-based-views/generic-date-based/","canonical":"https://djangodocs.dev/ja/5.1/ref/class-based-views/generic-date-based/","summary":"日付ベースのジェネリックビュー (django.views.generic.dates 内で提供されています) は、日付ベースのデータのために、ドリルダウンページを描画するためのビューです…","html":"

ジェネリック日付ビューLink to this heading#

\n

日付ベースのジェネリックビュー (django.views.generic.dates 内で提供されています) は、日付ベースのデータのために、ドリルダウンページを描画するためのビューです。

\n\n
\n

ArchiveIndexViewLink to this heading#

\n
\n
\nclass ArchiveIndexViewLink to this definition#
\n

"最新の"オブジェクトを、日付によって表示するトップレベルのインデックスページです。allow_future を True にセットしない限り、未来 の日付のオブジェクトは含まれません。

\n

継承元 (MRO)

\n\n

コンテキスト

\n

(django.views.generic.dates.BaseDateListView を通じた) django.views.generic.list.MultipleObjectMixin によって提供されたコンテキストに加えて、テンプレートのコンテキストは以下のようになります:

\n
    \n

  • date_list: queryset に従ってオブジェクトを利用可能にするすべての年を含む QuerySet オブジェクトです。datetime.datetime オブジェクトとして表され、降順で表示されます。

    • \n
\n

ノート

\n
    \n

  • デフォルトの 最新 の context_object_name を使います。

    • \n

  • デフォルトの _archive の template_name_suffix を使います。

    • \n

  • 年によって date_list を提供する動作がデフォルトですが、date_list_period 属性を用いた月や日に変更できます。これは、すべてのサブクラスのビューに適用されます。

    • \n
\n

例 myapp/urls.py:

\n
Code
from 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
\n

例 myapp/article_archive.html:

\n
Django template
<ul>\n    {% for article in latest %}\n        <li>{{ article.pub_date }}: {{ article.title }}</li>\n    {% endfor %}\n</ul>\n
\n

これは、すべての記事 (article) を出力します。

\n
\n\n
\n
\n

YearArchiveViewLink to this heading#

\n
\n
\nclass YearArchiveViewLink to this definition#
\n

与えられた年の中で有効な月を表示する、年次のアーカイブページです。allow_future を True にセットしない限り、未来 の日付を伴うオブジェクトは表示されません。

\n

継承元 (MRO)

\n\n
\n
\nmake_object_listLink to this definition#
\n

この年のオブジェクトの全リストを取得し、テンプレートに渡すかどうかを指定する真偽値。もし True なら、オブジェクトのリストがコンテキストで利用可能になります。 False の場合、オブジェクトリストとして None クエリセットが使用されます。デフォルトでは False です。

\n
\n\n
\n
\nget_make_object_list()Link to this definition#
\n

オブジェクトリストをコンテキストの一部として返すかどうかを決定します。デフォルトでは make_object_list を返します。

\n
\n\n

コンテキスト

\n

(django.views.generic.dates.BaseDateListView を通じた) django.views.generic.list.MultipleObjectMixin によって提供されたコンテキストに加えて、テンプレートのコンテキストは以下のようになります:

\n
    \n

  • date_list: QuerySet オブジェクトで、 datetime.datetime オブジェクトとして昇順に表現された、 queryset に従って利用可能なオブジェクトを持つ全ての月を含みます。

    • \n

  • year: 与えられた年を表す date オブジェクト。

    • \n

  • next_year: allow_empty と allow_future に従って、次の年の最初の日を表す date オブジェクト。

    • \n

  • previous_year: date オブジェクト。 allow_empty と allow_future に従います。

    • \n
\n

ノート

\n
    \n

  • デフォルトの template_name_suffix は _archive_year です。

    • \n
\n

例 myapp/views.py:

\n
Code
from 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
\n

例 myapp/urls.py:

\n
Code
from 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
\n

例 myapp/article_archive_year.html:

\n
Django template
<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>\n
\n
\n\n
\n
\n

MonthArchiveViewLink to this heading#

\n
\n
\nclass MonthArchiveViewLink to this definition#
\n

与えられた月の中で有効な全オブジェクトを表示する、月次のアーカイブページです。allow_future を True にセットしない限り、未来 の日付を伴うオブジェクトは表示されません。

\n

継承元 (MRO)

\n\n

コンテキスト

\n

MultipleObjectMixin (BaseDateListView 経由) によって提供されるコンテキストに加えて、テンプレートのコンテキストも提供されます：

\n
    \n

  • date_list: QuerySet オブジェクトで、 queryset に従って、与えられた月にオブジェクトが利用可能な全ての日を、 datetime.datetime オブジェクトとして昇順で表します。

    • \n

  • month: 与えられた月を表す date オブジェクト。

    • \n

  • next_month: allow_empty と allow_future に従って、次の月の最初の日を表す date オブジェクト。

    • \n

  • previous_month: allow_empty と allow_future に従って、前月の最初の日を表す date オブジェクト。

    • \n
\n

ノート

\n
    \n

  • デフォルトの template_name_suffix は _archive_month です。

    • \n
\n

例 myapp/views.py:

\n
Code
from 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
\n

例 myapp/urls.py:

\n
Code
from 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
\n

例 myapp/article_archive_month.html:

\n
Django template
<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>\n
\n
\n\n
\n
\n

WeekArchiveViewLink to this heading#

\n
\n
\nclass WeekArchiveViewLink to this definition#
\n

与えられた週の中で有効な全オブジェクトを表示する、週次のアーカイブページです。allow_future を True にセットしない限り、未来 の日付を伴うオブジェクトは表示されません。

\n

継承元 (MRO)

\n\n

コンテキスト

\n

MultipleObjectMixin (BaseDateListView 経由) によって提供されるコンテキストに加えて、テンプレートのコンテキストも提供されます：

\n
    \n

  • week: 指定した週の最初の日を表す date オブジェクト。

    • \n

  • next_week: allow_empty と allow_future に従って、次の週の最初の日を表す date オブジェクト。

    • \n

  • previous_week: allow_empty と allow_future に従って、前の週の最初の日を表す date オブジェクト。

    • \n
\n

ノート

\n
    \n

  • デフォルトの template_name_suffix は _archive_week です。

    • \n

  • week_format 属性は strptime() フォーマット文字列で、週番号をパースするために使用されます。以下の値がサポートされています：

    \n
      \n

    • '%U': 日曜日が週の始まりとなるアメリカ合衆国の週システムに基づきます。これはデフォルト値です。

      • \n

    • '%W': '%U' と似ていますが、週が月曜日から始まると仮定している点が異なります。これはISO 8601の週番号とは異なります。

      • \n

    • '%V': 週が月曜日から始まるISO 8601の週番号。

      • \n
    \n
    • \n
\n

例 myapp/views.py:

\n
Code
from 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
\n

例 myapp/urls.py:

\n
Code
from 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
\n

例 myapp/article_archive_week.html:

\n
Django template
<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
\n

この例では週番号を出力しています。 テンプレートフィルタの date が 'W' フォーマット文字列で計算した週番号は、 strftime() や strptime() が '%W' フォーマット文字列で計算した週番号と必ずしも同じではないことに注意してください。例えば2015年の場合、 date が出力する週番号は strftime() が出力する週番号よりも1つ大きくなります。date には '%U' strftime() の書式文字列と等価なものはありません。そのため、 date を使って WeekArchiveView の URL を生成することは避けるべきです。

\n
\n\n
\n
\n

DayArchiveViewLink to this heading#

\n
\n
\nclass DayArchiveViewLink to this definition#
\n

与えられた日の中で有効な全オブジェクトを表示する、日次のアーカイブページです。allow_future を True にセットしない限り、未来の日付に対するオブジェクトがするかどうかにかかわらず、未来の日付は 404 エラーを返します。

\n

継承元 (MRO)

\n\n

コンテキスト

\n

MultipleObjectMixin (BaseDateListView 経由) によって提供されるコンテキストに加えて、テンプレートのコンテキストも提供されます：

\n\n

ノート

\n
    \n

  • デフォルトの template_name_suffix は _archive_day です。

    • \n
\n

例 myapp/views.py:

\n
Code
from 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
\n

例 myapp/urls.py:

\n
Code
from 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
\n

例 myapp/article_archive_day.html:

\n
Django template
<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>\n
\n
\n\n
\n
\n

TodayArchiveViewLink to this heading#

\n
\n
\nclass TodayArchiveViewLink to this definition#
\n

今日 の全てのオブジェクトを表示する、日時のアーカイブページです。年 / 月 / 日 引数の代わりに今日の日付が使われること以外は、django.views.generic.dates.DayArchiveView とまったく同じです。

\n

継承元 (MRO)

\n\n

ノート

\n
    \n

  • デフォルトの template_name_suffix は _archive_today です。

    • \n
\n

例 myapp/views.py:

\n
Code
from 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
\n

例 myapp/urls.py:

\n
Code
from django.urls import path\n\nfrom myapp.views import ArticleTodayArchiveView\n\nurlpatterns = [\n    path("today/", ArticleTodayArchiveView.as_view(), name="archive_today"),\n]\n
\n\n
\n\n
\n
\n

DateDetailViewLink to this heading#

\n
\n
\nclass DateDetailViewLink to this definition#
\n

個別のオブジェクトを表示するページです。オブジェクトが未来の日付値を持っている場合、allow_future を True にセットしない限り、デフォルトでビューは 404 エラーを返します。

\n

継承元 (MRO)

\n\n

コンテキスト

\n
    \n

  • DateDetailView で指定された model に関連付けられたオブジェクトを1つだけ含みます。

    • \n
\n

ノート

\n
    \n

  • デフォルトの template_name_suffix は _detail です。

    • \n
\n

例 myapp/urls.py:

\n
Code
from 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
\n

例 myapp/article_detail.html:

\n
Django template
<h1>{{ object.title }}</h1>\n
\n
\n\n\n
","rootId":"module-django.views.generic.dates","toc":[{"title":"ArchiveIndexView","anchor":"archiveindexview","children":[]},{"title":"YearArchiveView","anchor":"yeararchiveview","children":[]},{"title":"MonthArchiveView","anchor":"montharchiveview","children":[]},{"title":"WeekArchiveView","anchor":"weekarchiveview","children":[]},{"title":"DayArchiveView","anchor":"dayarchiveview","children":[]},{"title":"TodayArchiveView","anchor":"todayarchiveview","children":[]},{"title":"DateDetailView","anchor":"datedetailview","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"API リファレンス","url":"/ja/5.1/ref/"},{"docname":"ref/class-based-views/index","title":"ビルトインのクラスベースビュー API","url":"/ja/5.1/ref/class-based-views/"}],"prev":{"docname":"ref/class-based-views/generic-editing","title":"ジェネリック編集ビュー (Generic editing view)","url":"/ja/5.1/ref/class-based-views/generic-editing/"},"next":{"docname":"ref/class-based-views/mixins","title":"クラスベースビューのミックスイン (mixin)","url":"/ja/5.1/ref/class-based-views/mixins/"},"formats":{"html":"/ja/5.1/ref/class-based-views/generic-date-based/","markdown":"/ja/5.1/ref/class-based-views/generic-date-based.md","json":"/ja/5.1/ref/class-based-views/generic-date-based.json"},"source":"https://github.com/django/django/blob/stable/5.1.x/docs/ref/class-based-views/generic-date-based.txt","official":"https://docs.djangoproject.com/ja/5.1/ref/class-based-views/generic-date-based/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}