日付ベースのミックスイン (mixin)¶
注釈
これらのミックスインに含まれるすべての日付フォーマット属性は strftime() フォーマット文字列を使用します。 now テンプレートタグのフォーマット文字列は互換性がないので使用しないでください。
YearMixin¶
- class YearMixin[ソース]¶
日付の「年」コンポーネントのパース情報を取得したり提供したりするために使用できるミックスイン。
メソッドと属性
- year_format¶
strftime()のフォーマットで年をパースします。デフォルトでは'%Y'です。
- year¶
オプション 年の値を文字列で指定します。デフォルトでは
Noneに設定されています。これは他の方法で年を決定することを意味します。
- get_year_format()[ソース]¶
年をパースする際に使用する
strftime()フォーマットを返します。デフォルトではyear_formatを返します。
- get_year()[ソース]¶
このビューがデータを表示する年を文字列で返します。以下のソースを順に試みます：
YearMixin.year属性の値。URL パターンに含まれる
year引数の値。GETクエリ引数yearの値。
有効な年指定が見つからない場合は 404 を返します。
- get_next_year(date)[ソース]¶
指定した日付の翌年の最初の日を含む日付オブジェクトを返します。この関数は
allow_emptyとallow_futureの値によってNoneを返したり、Http404例外を発生させたりします。
- get_previous_year(date)[ソース]¶
指定した日付の前の年の最初の日を含む日付オブジェクトを返します。この関数は
allow_emptyとallow_futureの値によってNoneを返したり、Http404例外を発生させたりします。
MonthMixin¶
- class MonthMixin[ソース]¶
日付の「月」コンポーネントのパース情報を取得したり提供したりするために使用できるミックスイン。
メソッドと属性
- month_format¶
strftime()フォーマットは月をパースするときに使われます。デフォルトでは'%b'です。
- month¶
オプション 月を表す文字列。デフォルトでは
Noneに設定されています。これは月が他の方法で決定されることを意味します。
- get_month_format()[ソース]¶
月をパースする際に使用する
strftime()フォーマットを返します。デフォルトではmonth_formatを返します。
- get_month()[ソース]¶
このビューがデータを表示する月を文字列で返します。以下のソースを順に試みます：
MonthMixin.month属性の値です。URL パターンからキャプチャされた
month引数の値。GETクエリ引数monthの値。
有効な月の指定が見つからない場合は 404 を返します。
- get_next_month(date)[ソース]¶
指定した日付の翌月初日を含む日付オブジェクトを返します。この関数は
allow_emptyとallow_futureの値によってNoneを返したり、Http404例外が発生したりします。
- get_previous_month(date)[ソース]¶
指定した日付の前の月の最初の日を含む日付オブジェクトを返します。この関数は
allow_emptyとallow_futureの値によってNoneを返したり、Http404例外を発生させたりします。
DayMixin¶
- class DayMixin[ソース]¶
日付の「日」コンポーネントのパース情報を取得したり提供したりするために使用できるミックスインです。
メソッドと属性
- day_format¶
日をパースする際に使用する
strftime()フォーマットです。デフォルトでは'%d'です。
- day¶
オプション 文字列で日の値を指定します。デフォルトでは
Noneに設定されています。これは別の方法で日を決定することを意味します。
- get_day_format()[ソース]¶
日をパースする際に使用する
strftime()フォーマットを返します。デフォルトではday_formatを返します。
- get_day()[ソース]¶
このビューがデータを表示する日を文字列で返します。以下のソースを順に試みます：
DayMixin.day属性の値。URL パターンからキャプチャされた
day引数の値。GETクエリ引数dayの値。
有効な日の指定が見つからない場合は 404 を返します。
- get_next_day(date)[ソース]¶
指定された日の有効な翌日を含む日付オブジェクトを返します。この関数は
allow_emptyとallow_futureの値によってNoneを返したり、Http404例外を発生させたりします。
- get_previous_day(date)[ソース]¶
有効な前日を含む日付オブジェクトを返します。この関数は
allow_emptyとallow_futureの値によってNoneを返したり、Http404例外を発生させたりします。
WeekMixin¶
- class WeekMixin[ソース]¶
日付の「週」コンポーネントのパース情報を取得したり提供したりするために使用できるミックスイン。
メソッドと属性
- week_format¶
週をパースする際に使用する
strftime()フォーマットです。デフォルトでは'%U'です。週が月曜日から始めたい場合は'%W'または'%V'(ISO 8601 week) に設定します。
- week¶
オプション 週の値を文字列で指定します。デフォルトでは
Noneに設定されています。これは他の方法で週を決定することを意味します。
- get_week_format()[ソース]¶
週のパース時に使用する
strftime()フォーマットを返します。デフォルトではweek_formatを返します。
- get_week()[ソース]¶
このビューがデータを表示する週を文字列で返します。以下のソースを順に試みます：
WeekMixin.week属性の値。URL パターンからキャプチャされた
week引数の値weekGETクエリ引数の値。
有効な週の指定が見つからない場合、404を発生させます。
- get_next_week(date)[ソース]¶
指定した日付の、次の週の初日のdateオブジェクトを返します。またこの関数は、
allow_emptyとallow_futureの値によっては、Noneを返すか、Http404例外を発生させることがあります。
- get_prev_week(date)¶
指定した日付の、前の週の初日のdateオブジェクトを返します。またこの関数は、
allow_emptyとallow_futureの値によっては、Noneを返すか、Http404例外を発生させることがあります。
DateMixin¶
- class DateMixin[ソース]¶
すべてのデータベースのビューに共通の動作を提供する mixin クラス。
メソッドと属性
- date_field¶
QuerySetのモデル内のDateFieldまたはDateTimeFieldの名前です。日付ベースのアーカイブがページに表示するオブジェクトのリストを決定する際に使用します。タイムゾーンサポート が有効で
date_fieldがDateTimeFieldである場合、日付はカレントタイムゾーンにあると仮定されます。そうでない場合、クエリセットにはエンドユーザのタイムゾーンにおける前日または翌日のオブジェクトが含まれる可能性があります。警告
このような場合、ユーザーごとのタイムゾーン選択を実装していると、同じURLでもエンドユーザーのタイムゾーンによって異なるオブジェクトが表示される可能性があります。これを避けるためには、
date_field属性としてDateFieldを使用する必要があります。
- allow_future¶
このページに "未来" のオブジェクトを含めるかどうかを指定する真偽値です。"未来" とは
date_fieldで指定されたフィールドが現在の日時よりも大きいオブジェクトを意味します。デフォルトではFalseです。
- get_date_field()[ソース]¶
このビューが操作する日付データを含むフィールドの名前を返します。デフォルトでは
date_fieldを返します。
- get_allow_future()[ソース]¶
このページに "未来" のオブジェクトを含めるかどうかを判定します。ここで "未来" とは
date_fieldで指定されたフィールドが現在の日時よりも大きいオブジェクトを意味します。デフォルトではallow_futureを返します。
BaseDateListView¶
- class BaseDateListView[ソース]¶
すべての日付ベースのビューに共通の動作を提供する基本クラスです。通常は
BaseDateListViewをインスタンス化する理由はないでしょう。代わりにサブクラスをインスタンス化してください。このビュー（とそのサブクラス）が実行されている間、
self.object_listにはビューが操作しているオブジェクトのリストが格納され、self.date_listにはデータが利用可能な日付のリストが格納されます。ミックスイン
メソッドと属性
- allow_empty¶
オブジェクトがない場合にページを表示するかどうかを指定する真偽値。これが
Trueでオブジェクトがない場合、ビューは 404 を返す代わりに空のページを表示します。これは
django.views.generic.list.MultipleObjectMixin.allow_emptyと同様ですが、デフォルト値はFalseです。
- date_list_period¶
オプション
date_listの集計期間を定義する文字列。'year'(デフォルト)、'month'、'day'のいずれかを指定します。
- get_dated_items()[ソース]¶
(
date_list,object_list,extra_context) を含む 3-タプルを返します。date_listはデータが利用可能な日付のリストです。object_listはオブジェクトのリストです。extra_contextはコンテキストデータの辞書で、MultipleObjectMixinによって提供されるコンテキストデータに追加されます。
- get_dated_queryset(**lookup)[ソース]¶
lookupで定義したクエリ引数でフィルタしたクエリセットを返します。allow_emptyやallow_futureなどのクエリセットの制限を強制します。
- get_date_list_period()[ソース]¶
date_listの集計期間を返します。 デフォルトではdate_list_periodを返します。
- get_date_list(queryset, date_type=None, ordering='ASC')[ソース]¶
querysetがエントリを含むdate_type型の日付のリストを返します。 たとえば、get_date_list(qs, 'year')はqsがエントリを持つ年のリストを返します。もしdate_typeが指定されなかった場合、get_date_list_period()の結果が使用されます。date_typeとorderingはQuerySet.dates()に渡されます。
