{"title":"日付ベースのミックスイン (mixin)","version":"5.1","locale":"ja","docname":"ref/class-based-views/mixins-date-based","url":"/ja/5.1/ref/class-based-views/mixins-date-based/","canonical":"https://djangodocs.dev/ja/5.1/ref/class-based-views/mixins-date-based/","summary":"日付の「年」コンポーネントのパース情報を取得したり提供したりするために使用できるミックスイン。strftime() のフォーマットで年をパースします。","html":"<h1>日付ベースのミックスイン (mixin)<a class=\"heading-anchor\" href=\"#date-based-mixins\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<aside class=\"admonition admonition-note\" role=\"note\">\n<p class=\"admonition-title\">注釈</p>\n<p>これらのミックスインに含まれるすべての日付フォーマット属性は <a class=\"reference external\" href=\"https://docs.python.org/3/library/time.html#time.strftime\" title=\"(in Python v3.14)\"><code class=\"xref py py-func docutils literal notranslate\">strftime()</code></a> フォーマット文字列を使用します。 <a class=\"reference internal\" href=\"/ja/5.1/ref/templates/builtins/#std-templatetag-now\"><code class=\"xref std std-ttag docutils literal notranslate\">now</code></a> テンプレートタグのフォーマット文字列は互換性がないので使用しないでください。</p>\n</aside>\n<section id=\"yearmixin\">\n<h2><code class=\"docutils literal notranslate\">YearMixin</code><a class=\"heading-anchor\" href=\"#yearmixin\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.YearMixin\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-name descname\">YearMixin</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.YearMixin\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>日付の「年」コンポーネントのパース情報を取得したり提供したりするために使用できるミックスイン。</p>\n<p><strong>メソッドと属性</strong></p>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.YearMixin.year_format\">\n<span class=\"sig-name descname\">year_format</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.YearMixin.year_format\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><a class=\"reference external\" href=\"https://docs.python.org/3/library/time.html#time.strftime\" title=\"(in Python v3.14)\"><code class=\"xref py py-func docutils literal notranslate\">strftime()</code></a> のフォーマットで年をパースします。デフォルトでは <code class=\"docutils literal notranslate\">'%Y'</code> です。</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.YearMixin.year\">\n<span class=\"sig-name descname\">year</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.YearMixin.year\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><strong>オプション</strong> 年の値を文字列で指定します。デフォルトでは <code class=\"docutils literal notranslate\">None</code> に設定されています。これは他の方法で年を決定することを意味します。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.YearMixin.get_year_format\">\n<span class=\"sig-name descname\">get_year_format</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.YearMixin.get_year_format\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>年をパースする際に使用する <a class=\"reference external\" href=\"https://docs.python.org/3/library/time.html#time.strftime\" title=\"(in Python v3.14)\"><code class=\"xref py py-func docutils literal notranslate\">strftime()</code></a> フォーマットを返します。デフォルトでは <a class=\"reference internal\" href=\"#django.views.generic.dates.YearMixin.year_format\" title=\"django.views.generic.dates.YearMixin.year_format\"><code class=\"xref py py-attr docutils literal notranslate\">year_format</code></a> を返します。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.YearMixin.get_year\">\n<span class=\"sig-name descname\">get_year</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.YearMixin.get_year\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>このビューがデータを表示する年を文字列で返します。以下のソースを順に試みます：</p>\n<ul class=\"simple\">\n<li><p><a class=\"reference internal\" href=\"#django.views.generic.dates.YearMixin.year\" title=\"django.views.generic.dates.YearMixin.year\"><code class=\"xref py py-attr docutils literal notranslate\">YearMixin.year</code></a> 属性の値。</p></li>\n<li><p>URL パターンに含まれる <code class=\"docutils literal notranslate\">year</code> 引数の値。</p></li>\n<li><p><code class=\"docutils literal notranslate\">GET</code> クエリ引数 <code class=\"docutils literal notranslate\">year</code> の値。</p></li>\n</ul>\n<p>有効な年指定が見つからない場合は 404 を返します。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.YearMixin.get_next_year\">\n<span class=\"sig-name descname\">get_next_year</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">date</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.YearMixin.get_next_year\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>指定した日付の翌年の最初の日を含む日付オブジェクトを返します。この関数は <a class=\"reference internal\" href=\"#django.views.generic.dates.BaseDateListView.allow_empty\" title=\"django.views.generic.dates.BaseDateListView.allow_empty\"><code class=\"xref py py-attr docutils literal notranslate\">allow_empty</code></a> と <a class=\"reference internal\" href=\"#django.views.generic.dates.DateMixin.allow_future\" title=\"django.views.generic.dates.DateMixin.allow_future\"><code class=\"xref py py-attr docutils literal notranslate\">allow_future</code></a> の値によって <code class=\"docutils literal notranslate\">None</code> を返したり、 <a class=\"reference internal\" href=\"/ja/5.1/topics/http/views/#django.http.Http404\" title=\"django.http.Http404\"><code class=\"xref py py-class docutils literal notranslate\">Http404</code></a> 例外を発生させたりします。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.YearMixin.get_previous_year\">\n<span class=\"sig-name descname\">get_previous_year</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">date</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.YearMixin.get_previous_year\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>指定した日付の前の年の最初の日を含む日付オブジェクトを返します。この関数は <a class=\"reference internal\" href=\"#django.views.generic.dates.BaseDateListView.allow_empty\" title=\"django.views.generic.dates.BaseDateListView.allow_empty\"><code class=\"xref py py-attr docutils literal notranslate\">allow_empty</code></a> と <a class=\"reference internal\" href=\"#django.views.generic.dates.DateMixin.allow_future\" title=\"django.views.generic.dates.DateMixin.allow_future\"><code class=\"xref py py-attr docutils literal notranslate\">allow_future</code></a> の値によって <code class=\"docutils literal notranslate\">None</code> を返したり、 <a class=\"reference internal\" href=\"/ja/5.1/topics/http/views/#django.http.Http404\" title=\"django.http.Http404\"><code class=\"xref py py-class docutils literal notranslate\">Http404</code></a> 例外を発生させたりします。</p>\n</dd></dl>\n\n</dd></dl>\n\n</section>\n<section id=\"monthmixin\">\n<h2><code class=\"docutils literal notranslate\">MonthMixin</code><a class=\"heading-anchor\" href=\"#monthmixin\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.MonthMixin\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-name descname\">MonthMixin</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.MonthMixin\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>日付の「月」コンポーネントのパース情報を取得したり提供したりするために使用できるミックスイン。</p>\n<p><strong>メソッドと属性</strong></p>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.MonthMixin.month_format\">\n<span class=\"sig-name descname\">month_format</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.MonthMixin.month_format\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><a class=\"reference external\" href=\"https://docs.python.org/3/library/time.html#time.strftime\" title=\"(in Python v3.14)\"><code class=\"xref py py-func docutils literal notranslate\">strftime()</code></a> フォーマットは月をパースするときに使われます。デフォルトでは <code class=\"docutils literal notranslate\">'%b'</code> です。</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.MonthMixin.month\">\n<span class=\"sig-name descname\">month</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.MonthMixin.month\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><strong>オプション</strong> 月を表す文字列。デフォルトでは <code class=\"docutils literal notranslate\">None</code> に設定されています。これは月が他の方法で決定されることを意味します。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.MonthMixin.get_month_format\">\n<span class=\"sig-name descname\">get_month_format</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.MonthMixin.get_month_format\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>月をパースする際に使用する <a class=\"reference external\" href=\"https://docs.python.org/3/library/time.html#time.strftime\" title=\"(in Python v3.14)\"><code class=\"xref py py-func docutils literal notranslate\">strftime()</code></a> フォーマットを返します。デフォルトでは <a class=\"reference internal\" href=\"#django.views.generic.dates.MonthMixin.month_format\" title=\"django.views.generic.dates.MonthMixin.month_format\"><code class=\"xref py py-attr docutils literal notranslate\">month_format</code></a> を返します。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.MonthMixin.get_month\">\n<span class=\"sig-name descname\">get_month</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.MonthMixin.get_month\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>このビューがデータを表示する月を文字列で返します。以下のソースを順に試みます：</p>\n<ul class=\"simple\">\n<li><p><a class=\"reference internal\" href=\"#django.views.generic.dates.MonthMixin.month\" title=\"django.views.generic.dates.MonthMixin.month\"><code class=\"xref py py-attr docutils literal notranslate\">MonthMixin.month</code></a> 属性の値です。</p></li>\n<li><p>URL パターンからキャプチャされた <code class=\"docutils literal notranslate\">month</code> 引数の値。</p></li>\n<li><p><code class=\"docutils literal notranslate\">GET</code> クエリ引数 <code class=\"docutils literal notranslate\">month</code> の値。</p></li>\n</ul>\n<p>有効な月の指定が見つからない場合は 404 を返します。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.MonthMixin.get_next_month\">\n<span class=\"sig-name descname\">get_next_month</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">date</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.MonthMixin.get_next_month\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>指定した日付の翌月初日を含む日付オブジェクトを返します。この関数は <a class=\"reference internal\" href=\"#django.views.generic.dates.BaseDateListView.allow_empty\" title=\"django.views.generic.dates.BaseDateListView.allow_empty\"><code class=\"xref py py-attr docutils literal notranslate\">allow_empty</code></a> と <a class=\"reference internal\" href=\"#django.views.generic.dates.DateMixin.allow_future\" title=\"django.views.generic.dates.DateMixin.allow_future\"><code class=\"xref py py-attr docutils literal notranslate\">allow_future</code></a> の値によって <code class=\"docutils literal notranslate\">None</code> を返したり、 <a class=\"reference internal\" href=\"/ja/5.1/topics/http/views/#django.http.Http404\" title=\"django.http.Http404\"><code class=\"xref py py-class docutils literal notranslate\">Http404</code></a> 例外が発生したりします。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.MonthMixin.get_previous_month\">\n<span class=\"sig-name descname\">get_previous_month</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">date</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.MonthMixin.get_previous_month\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>指定した日付の前の月の最初の日を含む日付オブジェクトを返します。この関数は <a class=\"reference internal\" href=\"#django.views.generic.dates.BaseDateListView.allow_empty\" title=\"django.views.generic.dates.BaseDateListView.allow_empty\"><code class=\"xref py py-attr docutils literal notranslate\">allow_empty</code></a> と <a class=\"reference internal\" href=\"#django.views.generic.dates.DateMixin.allow_future\" title=\"django.views.generic.dates.DateMixin.allow_future\"><code class=\"xref py py-attr docutils literal notranslate\">allow_future</code></a> の値によって <code class=\"docutils literal notranslate\">None</code> を返したり、 <a class=\"reference internal\" href=\"/ja/5.1/topics/http/views/#django.http.Http404\" title=\"django.http.Http404\"><code class=\"xref py py-class docutils literal notranslate\">Http404</code></a> 例外を発生させたりします。</p>\n</dd></dl>\n\n</dd></dl>\n\n</section>\n<section id=\"daymixin\">\n<h2><code class=\"docutils literal notranslate\">DayMixin</code><a class=\"heading-anchor\" href=\"#daymixin\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.DayMixin\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-name descname\">DayMixin</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.DayMixin\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>日付の「日」コンポーネントのパース情報を取得したり提供したりするために使用できるミックスインです。</p>\n<p><strong>メソッドと属性</strong></p>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.DayMixin.day_format\">\n<span class=\"sig-name descname\">day_format</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.DayMixin.day_format\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>日をパースする際に使用する <a class=\"reference external\" href=\"https://docs.python.org/3/library/time.html#time.strftime\" title=\"(in Python v3.14)\"><code class=\"xref py py-func docutils literal notranslate\">strftime()</code></a> フォーマットです。デフォルトでは <code class=\"docutils literal notranslate\">'%d'</code> です。</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.DayMixin.day\">\n<span class=\"sig-name descname\">day</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.DayMixin.day\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><strong>オプション</strong> 文字列で日の値を指定します。デフォルトでは <code class=\"docutils literal notranslate\">None</code> に設定されています。これは別の方法で日を決定することを意味します。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.DayMixin.get_day_format\">\n<span class=\"sig-name descname\">get_day_format</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.DayMixin.get_day_format\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>日をパースする際に使用する <a class=\"reference external\" href=\"https://docs.python.org/3/library/time.html#time.strftime\" title=\"(in Python v3.14)\"><code class=\"xref py py-func docutils literal notranslate\">strftime()</code></a> フォーマットを返します。デフォルトでは <a class=\"reference internal\" href=\"#django.views.generic.dates.DayMixin.day_format\" title=\"django.views.generic.dates.DayMixin.day_format\"><code class=\"xref py py-attr docutils literal notranslate\">day_format</code></a> を返します。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.DayMixin.get_day\">\n<span class=\"sig-name descname\">get_day</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.DayMixin.get_day\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>このビューがデータを表示する日を文字列で返します。以下のソースを順に試みます：</p>\n<ul class=\"simple\">\n<li><p><a class=\"reference internal\" href=\"#django.views.generic.dates.DayMixin.day\" title=\"django.views.generic.dates.DayMixin.day\"><code class=\"xref py py-attr docutils literal notranslate\">DayMixin.day</code></a> 属性の値。</p></li>\n<li><p>URL パターンからキャプチャされた <code class=\"docutils literal notranslate\">day</code> 引数の値。</p></li>\n<li><p><code class=\"docutils literal notranslate\">GET</code> クエリ引数 <code class=\"docutils literal notranslate\">day</code> の値。</p></li>\n</ul>\n<p>有効な日の指定が見つからない場合は 404 を返します。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.DayMixin.get_next_day\">\n<span class=\"sig-name descname\">get_next_day</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">date</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.DayMixin.get_next_day\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>指定された日の有効な翌日を含む日付オブジェクトを返します。この関数は <a class=\"reference internal\" href=\"#django.views.generic.dates.BaseDateListView.allow_empty\" title=\"django.views.generic.dates.BaseDateListView.allow_empty\"><code class=\"xref py py-attr docutils literal notranslate\">allow_empty</code></a> と <a class=\"reference internal\" href=\"#django.views.generic.dates.DateMixin.allow_future\" title=\"django.views.generic.dates.DateMixin.allow_future\"><code class=\"xref py py-attr docutils literal notranslate\">allow_future</code></a> の値によって <code class=\"docutils literal notranslate\">None</code> を返したり、 <a class=\"reference internal\" href=\"/ja/5.1/topics/http/views/#django.http.Http404\" title=\"django.http.Http404\"><code class=\"xref py py-class docutils literal notranslate\">Http404</code></a> 例外を発生させたりします。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.DayMixin.get_previous_day\">\n<span class=\"sig-name descname\">get_previous_day</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">date</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.DayMixin.get_previous_day\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>有効な前日を含む日付オブジェクトを返します。この関数は <a class=\"reference internal\" href=\"#django.views.generic.dates.BaseDateListView.allow_empty\" title=\"django.views.generic.dates.BaseDateListView.allow_empty\"><code class=\"xref py py-attr docutils literal notranslate\">allow_empty</code></a> と <a class=\"reference internal\" href=\"#django.views.generic.dates.DateMixin.allow_future\" title=\"django.views.generic.dates.DateMixin.allow_future\"><code class=\"xref py py-attr docutils literal notranslate\">allow_future</code></a> の値によって <code class=\"docutils literal notranslate\">None</code> を返したり、 <a class=\"reference internal\" href=\"/ja/5.1/topics/http/views/#django.http.Http404\" title=\"django.http.Http404\"><code class=\"xref py py-class docutils literal notranslate\">Http404</code></a> 例外を発生させたりします。</p>\n</dd></dl>\n\n</dd></dl>\n\n</section>\n<section id=\"weekmixin\">\n<h2><code class=\"docutils literal notranslate\">WeekMixin</code><a class=\"heading-anchor\" href=\"#weekmixin\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.WeekMixin\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-name descname\">WeekMixin</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.WeekMixin\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>日付の「週」コンポーネントのパース情報を取得したり提供したりするために使用できるミックスイン。</p>\n<p><strong>メソッドと属性</strong></p>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.WeekMixin.week_format\">\n<span class=\"sig-name descname\">week_format</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.WeekMixin.week_format\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>週をパースする際に使用する <a class=\"reference external\" href=\"https://docs.python.org/3/library/time.html#time.strftime\" title=\"(in Python v3.14)\"><code class=\"xref py py-func docutils literal notranslate\">strftime()</code></a> フォーマットです。デフォルトでは <code class=\"docutils literal notranslate\">'%U'</code> です。週が月曜日から始めたい場合は <code class=\"docutils literal notranslate\">'%W'</code> または <code class=\"docutils literal notranslate\">'%V'</code> (ISO 8601 week) に設定します。</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.WeekMixin.week\">\n<span class=\"sig-name descname\">week</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.WeekMixin.week\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><strong>オプション</strong> 週の値を文字列で指定します。デフォルトでは <code class=\"docutils literal notranslate\">None</code> に設定されています。これは他の方法で週を決定することを意味します。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.WeekMixin.get_week_format\">\n<span class=\"sig-name descname\">get_week_format</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.WeekMixin.get_week_format\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>週のパース時に使用する <a class=\"reference external\" href=\"https://docs.python.org/3/library/time.html#time.strftime\" title=\"(in Python v3.14)\"><code class=\"xref py py-func docutils literal notranslate\">strftime()</code></a> フォーマットを返します。デフォルトでは <a class=\"reference internal\" href=\"#django.views.generic.dates.WeekMixin.week_format\" title=\"django.views.generic.dates.WeekMixin.week_format\"><code class=\"xref py py-attr docutils literal notranslate\">week_format</code></a> を返します。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.WeekMixin.get_week\">\n<span class=\"sig-name descname\">get_week</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.WeekMixin.get_week\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>このビューがデータを表示する週を文字列で返します。以下のソースを順に試みます：</p>\n<ul class=\"simple\">\n<li><p><a class=\"reference internal\" href=\"#django.views.generic.dates.WeekMixin.week\" title=\"django.views.generic.dates.WeekMixin.week\"><code class=\"xref py py-attr docutils literal notranslate\">WeekMixin.week</code></a> 属性の値。</p></li>\n<li><p>URL パターンからキャプチャされた <code class=\"docutils literal notranslate\">week</code> 引数の値</p></li>\n<li><p><code class=\"docutils literal notranslate\">week</code> <code class=\"docutils literal notranslate\">GET</code> クエリ引数の値。</p></li>\n</ul>\n<p>有効な週の指定が見つからない場合、404を発生させます。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.WeekMixin.get_next_week\">\n<span class=\"sig-name descname\">get_next_week</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">date</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.WeekMixin.get_next_week\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>指定した日付の、次の週の初日のdateオブジェクトを返します。またこの関数は、 <a class=\"reference internal\" href=\"#django.views.generic.dates.BaseDateListView.allow_empty\" title=\"django.views.generic.dates.BaseDateListView.allow_empty\"><code class=\"xref py py-attr docutils literal notranslate\">allow_empty</code></a> と <a class=\"reference internal\" href=\"#django.views.generic.dates.DateMixin.allow_future\" title=\"django.views.generic.dates.DateMixin.allow_future\"><code class=\"xref py py-attr docutils literal notranslate\">allow_future</code></a> の値によっては、 <code class=\"docutils literal notranslate\">None</code> を返すか、 <a class=\"reference internal\" href=\"/ja/5.1/topics/http/views/#django.http.Http404\" title=\"django.http.Http404\"><code class=\"xref py py-class docutils literal notranslate\">Http404</code></a> 例外を発生させることがあります。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.WeekMixin.get_prev_week\">\n<span class=\"sig-name descname\">get_prev_week</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">date</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.WeekMixin.get_prev_week\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>指定した日付の、前の週の初日のdateオブジェクトを返します。またこの関数は、 <a class=\"reference internal\" href=\"#django.views.generic.dates.BaseDateListView.allow_empty\" title=\"django.views.generic.dates.BaseDateListView.allow_empty\"><code class=\"xref py py-attr docutils literal notranslate\">allow_empty</code></a> と <a class=\"reference internal\" href=\"#django.views.generic.dates.DateMixin.allow_future\" title=\"django.views.generic.dates.DateMixin.allow_future\"><code class=\"xref py py-attr docutils literal notranslate\">allow_future</code></a> の値によっては、 <code class=\"docutils literal notranslate\">None</code> を返すか、 <a class=\"reference internal\" href=\"/ja/5.1/topics/http/views/#django.http.Http404\" title=\"django.http.Http404\"><code class=\"xref py py-class docutils literal notranslate\">Http404</code></a> 例外を発生させることがあります。</p>\n</dd></dl>\n\n</dd></dl>\n\n</section>\n<section id=\"datemixin\">\n<h2><code class=\"docutils literal notranslate\">DateMixin</code><a class=\"heading-anchor\" href=\"#datemixin\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.DateMixin\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-name descname\">DateMixin</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.DateMixin\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>すべてのデータベースのビューに共通の動作を提供する mixin クラス。</p>\n<p><strong>メソッドと属性</strong></p>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.DateMixin.date_field\">\n<span class=\"sig-name descname\">date_field</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.DateMixin.date_field\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><code class=\"docutils literal notranslate\">QuerySet</code> のモデル内の <code class=\"docutils literal notranslate\">DateField</code> または <code class=\"docutils literal notranslate\">DateTimeField</code> の名前です。日付ベースのアーカイブがページに表示するオブジェクトのリストを決定する際に使用します。</p>\n<p><a class=\"reference internal\" href=\"/ja/5.1/topics/i18n/timezones/\"><span class=\"doc\">タイムゾーンサポート</span></a> が有効で <code class=\"docutils literal notranslate\">date_field</code> が <code class=\"docutils literal notranslate\">DateTimeField</code> である場合、日付はカレントタイムゾーンにあると仮定されます。そうでない場合、クエリセットにはエンドユーザのタイムゾーンにおける前日または翌日のオブジェクトが含まれる可能性があります。</p>\n<aside class=\"admonition admonition-warning\" role=\"note\">\n<p class=\"admonition-title\">警告</p>\n<p>このような場合、ユーザーごとのタイムゾーン選択を実装していると、同じURLでもエンドユーザーのタイムゾーンによって異なるオブジェクトが表示される可能性があります。これを避けるためには、 <code class=\"docutils literal notranslate\">date_field</code> 属性として <code class=\"docutils literal notranslate\">DateField</code> を使用する必要があります。</p>\n</aside>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.DateMixin.allow_future\">\n<span class=\"sig-name descname\">allow_future</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.DateMixin.allow_future\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>このページに &quot;未来&quot; のオブジェクトを含めるかどうかを指定する真偽値です。&quot;未来&quot; とは <code class=\"docutils literal notranslate\">date_field</code> で指定されたフィールドが現在の日時よりも大きいオブジェクトを意味します。デフォルトでは <code class=\"docutils literal notranslate\">False</code> です。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.DateMixin.get_date_field\">\n<span class=\"sig-name descname\">get_date_field</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.DateMixin.get_date_field\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>このビューが操作する日付データを含むフィールドの名前を返します。デフォルトでは <a class=\"reference internal\" href=\"#django.views.generic.dates.DateMixin.date_field\" title=\"django.views.generic.dates.DateMixin.date_field\"><code class=\"xref py py-attr docutils literal notranslate\">date_field</code></a> を返します。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.DateMixin.get_allow_future\">\n<span class=\"sig-name descname\">get_allow_future</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.DateMixin.get_allow_future\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>このページに &quot;未来&quot; のオブジェクトを含めるかどうかを判定します。ここで &quot;未来&quot; とは <code class=\"docutils literal notranslate\">date_field</code> で指定されたフィールドが現在の日時よりも大きいオブジェクトを意味します。デフォルトでは <a class=\"reference internal\" href=\"#django.views.generic.dates.DateMixin.allow_future\" title=\"django.views.generic.dates.DateMixin.allow_future\"><code class=\"xref py py-attr docutils literal notranslate\">allow_future</code></a> を返します。</p>\n</dd></dl>\n\n</dd></dl>\n\n</section>\n<section id=\"basedatelistview\">\n<h2><code class=\"docutils literal notranslate\">BaseDateListView</code><a class=\"heading-anchor\" href=\"#basedatelistview\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.BaseDateListView\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-name descname\">BaseDateListView</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.BaseDateListView\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>すべての日付ベースのビューに共通の動作を提供する基本クラスです。通常は <a class=\"reference internal\" href=\"#django.views.generic.dates.BaseDateListView\" title=\"django.views.generic.dates.BaseDateListView\"><code class=\"xref py py-class docutils literal notranslate\">BaseDateListView</code></a> をインスタンス化する理由はないでしょう。代わりにサブクラスをインスタンス化してください。</p>\n<p>このビュー（とそのサブクラス）が実行されている間、<code class=\"docutils literal notranslate\">self.object_list</code> にはビューが操作しているオブジェクトのリストが格納され、<code class=\"docutils literal notranslate\">self.date_list</code> にはデータが利用可能な日付のリストが格納されます。</p>\n<p><strong>ミックスイン</strong></p>\n<ul class=\"simple\">\n<li><p><a class=\"reference internal\" href=\"#django.views.generic.dates.DateMixin\" title=\"django.views.generic.dates.DateMixin\"><code class=\"xref py py-class docutils literal notranslate\">DateMixin</code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/ja/5.1/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin\" title=\"django.views.generic.list.MultipleObjectMixin\"><code class=\"xref py py-class docutils literal notranslate\">MultipleObjectMixin</code></a></p></li>\n</ul>\n<p><strong>メソッドと属性</strong></p>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.BaseDateListView.allow_empty\">\n<span class=\"sig-name descname\">allow_empty</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.BaseDateListView.allow_empty\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>オブジェクトがない場合にページを表示するかどうかを指定する真偽値。これが <code class=\"docutils literal notranslate\">True</code> でオブジェクトがない場合、ビューは 404 を返す代わりに空のページを表示します。</p>\n<p>これは <a class=\"reference internal\" href=\"/ja/5.1/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin.allow_empty\" title=\"django.views.generic.list.MultipleObjectMixin.allow_empty\"><code class=\"xref py py-attr docutils literal notranslate\">django.views.generic.list.MultipleObjectMixin.allow_empty</code></a> と同様ですが、デフォルト値は <code class=\"docutils literal notranslate\">False</code> です。</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.BaseDateListView.date_list_period\">\n<span class=\"sig-name descname\">date_list_period</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.BaseDateListView.date_list_period\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><strong>オプション</strong> <code class=\"docutils literal notranslate\">date_list</code> の集計期間を定義する文字列。 <code class=\"docutils literal notranslate\">'year'</code> (デフォルト)、<code class=\"docutils literal notranslate\">'month'</code>、<code class=\"docutils literal notranslate\">'day'</code> のいずれかを指定します。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.BaseDateListView.get_dated_items\">\n<span class=\"sig-name descname\">get_dated_items</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.BaseDateListView.get_dated_items\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>(<code class=\"docutils literal notranslate\">date_list</code>, <code class=\"docutils literal notranslate\">object_list</code>, <code class=\"docutils literal notranslate\">extra_context</code>) を含む 3-タプルを返します。</p>\n<p><code class=\"docutils literal notranslate\">date_list</code> はデータが利用可能な日付のリストです。 <code class=\"docutils literal notranslate\">object_list</code> はオブジェクトのリストです。 <code class=\"docutils literal notranslate\">extra_context</code> はコンテキストデータの辞書で、 <a class=\"reference internal\" href=\"/ja/5.1/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin\" title=\"django.views.generic.list.MultipleObjectMixin\"><code class=\"xref py py-class docutils literal notranslate\">MultipleObjectMixin</code></a> によって提供されるコンテキストデータに追加されます。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.BaseDateListView.get_dated_queryset\">\n<span class=\"sig-name descname\">get_dated_queryset</span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"o\">**</span>lookup</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.BaseDateListView.get_dated_queryset\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><code class=\"docutils literal notranslate\">lookup</code> で定義したクエリ引数でフィルタしたクエリセットを返します。 <code class=\"docutils literal notranslate\">allow_empty</code> や <code class=\"docutils literal notranslate\">allow_future</code> などのクエリセットの制限を強制します。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.BaseDateListView.get_date_list_period\">\n<span class=\"sig-name descname\">get_date_list_period</span><span class=\"sig-paren\">(</span><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.BaseDateListView.get_date_list_period\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><code class=\"docutils literal notranslate\">date_list</code> の集計期間を返します。 デフォルトでは <a class=\"reference internal\" href=\"#django.views.generic.dates.BaseDateListView.date_list_period\" title=\"django.views.generic.dates.BaseDateListView.date_list_period\"><code class=\"xref py py-attr docutils literal notranslate\">date_list_period</code></a> を返します。</p>\n</dd></dl>\n\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.views.generic.dates.BaseDateListView.get_date_list\">\n<span class=\"sig-name descname\">get_date_list</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">queryset</em>, <em class=\"sig-param\">date_type<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">ordering<span class=\"o\">=</span><span class=\"default_value\">'ASC'</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.views.generic.dates.BaseDateListView.get_date_list\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p><code class=\"docutils literal notranslate\">queryset</code> がエントリを含む <code class=\"docutils literal notranslate\">date_type</code> 型の日付のリストを返します。 たとえば、 <code class=\"docutils literal notranslate\">get_date_list(qs, 'year')</code> は <code class=\"docutils literal notranslate\">qs</code> がエントリを持つ年のリストを返します。もし <code class=\"docutils literal notranslate\">date_type</code> が指定されなかった場合、 <a class=\"reference internal\" href=\"#django.views.generic.dates.BaseDateListView.get_date_list_period\" title=\"django.views.generic.dates.BaseDateListView.get_date_list_period\"><code class=\"xref py py-meth docutils literal notranslate\">get_date_list_period()</code></a> の結果が使用されます。<code class=\"docutils literal notranslate\">date_type</code> と <code class=\"docutils literal notranslate\">ordering</code> は <a class=\"reference internal\" href=\"/ja/5.1/ref/models/querysets/#django.db.models.query.QuerySet.dates\" title=\"django.db.models.query.QuerySet.dates\"><code class=\"xref py py-meth docutils literal notranslate\">QuerySet.dates()</code></a> に渡されます。</p>\n</dd></dl>\n\n</dd></dl>\n\n</section>","rootId":"date-based-mixins","toc":[{"title":"YearMixin","anchor":"yearmixin","children":[]},{"title":"MonthMixin","anchor":"monthmixin","children":[]},{"title":"DayMixin","anchor":"daymixin","children":[]},{"title":"WeekMixin","anchor":"weekmixin","children":[]},{"title":"DateMixin","anchor":"datemixin","children":[]},{"title":"BaseDateListView","anchor":"basedatelistview","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/"},{"docname":"ref/class-based-views/mixins","title":"クラスベースビューのミックスイン (mixin)","url":"/ja/5.1/ref/class-based-views/mixins/"}],"prev":{"docname":"ref/class-based-views/mixins-editing","title":"ミックスイン (mixin) を編集する","url":"/ja/5.1/ref/class-based-views/mixins-editing/"},"next":{"docname":"ref/class-based-views/flattened-index","title":"クラスベースのジェネリックビュー: フラットインデックス","url":"/ja/5.1/ref/class-based-views/flattened-index/"},"formats":{"html":"/ja/5.1/ref/class-based-views/mixins-date-based/","markdown":"/ja/5.1/ref/class-based-views/mixins-date-based.md","json":"/ja/5.1/ref/class-based-views/mixins-date-based.json"},"source":"https://github.com/django/django/blob/stable/5.1.x/docs/ref/class-based-views/mixins-date-based.txt","official":"https://docs.djangoproject.com/ja/5.1/ref/class-based-views/mixins-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"]}