Общие представления даты - Django Документация на русском

`ArchiveIndexView`¶

класс ArchiveIndexView¶

Индексная страница верхнего уровня, показывающая «самые последние» объекты по дате. Объекты с датой в будущем не включаются, если вы не установите allow_futureзначение True.

Предки (ТОиР)

Контекст

В дополнение к контексту, предоставленному django.views.generic.list.MultipleObjectMixin(via django.views.generic.dates.BaseDateListView), контекст шаблона будет:

date_list: QuerySet Объект, содержащий все годы, по которым есть объекты, доступные в порядке queryset, представленные в виде datetime.datetimeобъектов в порядке убывания.

Заметки

По умолчанию context_object_nameиспользуется latest.
По умолчанию template_name_suffixиспользуется _archive.
По умолчанию предоставляется date_listпо годам, но это можно изменить на месяц или день с помощью атрибута date_list_period. Это также относится ко всем представлениям подкласса.

Пример myapp / urls.py :

from django.urls import path
from django.views.generic.dates import ArchiveIndexView

from myapp.models import Article

urlpatterns = [
    path('archive/',
         ArchiveIndexView.as_view(model=Article, date_field="pub_date"),
         name="article_archive"),
]

Пример myapp / article_archive.html :

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

Это выведет все статьи.

`YearArchiveView`¶

класс YearArchiveView¶

Страница годового архива, показывающая все доступные месяцы в данном году. Объекты с датой в будущем не отображаются, если вы не установите allow_futureзначение True.

Предки (ТОиР)

make_object_list¶: Логическое значение, указывающее, следует ли получить полный список объектов за этот год и передать их в шаблон. Если True, список объектов будет доступен контексту. Если False, Noneнабор запросов будет использоваться как список объектов. По умолчанию это False.

get_make_object_list() ¶: Определите, будет ли список объектов возвращен как часть контекста. Возврат make_object_listпо умолчанию.

Контекст

В дополнение к контексту, предоставленному django.views.generic.list.MultipleObjectMixin(via django.views.generic.dates.BaseDateListView), контекст шаблона будет:

date_list: QuerySet Объект, содержащий все месяцы, в которых есть объекты, доступные в соответствии с querysetпредставленными в виде datetime.datetimeобъектов в возрастающем порядке.
year: dateОбъект, представляющий данный год.
next_year: dateОбъект, представляющий первый день следующего года в соответствии с allow_emptyи allow_future.
previous_year: dateОбъект, представляющий первый день предыдущего года в соответствии с allow_emptyи allow_future.

Заметки

По умолчанию template_name_suffixиспользуется _archive_year.

Пример myapp / views.py :

from django.views.generic.dates import YearArchiveView

from myapp.models import Article

class ArticleYearArchiveView(YearArchiveView):
    queryset = Article.objects.all()
    date_field = "pub_date"
    make_object_list = True
    allow_future = True

Пример myapp / urls.py :

from django.urls import path

from myapp.views import ArticleYearArchiveView

urlpatterns = [
    path('<int:year>/',
         ArticleYearArchiveView.as_view(),
         name="article_year_archive"),
]

Пример myapp / article_archive_year.html :

<ul>
    {% for date in date_list %}
        <li>{{ date|date }}</li>
    {% endfor %}
</ul>

<div>
    <h1>All Articles for {{ year|date:"Y" }}</h1>
    {% for obj in object_list %}
        <p>
            {{ obj.title }} - {{ obj.pub_date|date:"F j, Y" }}
        </p>
    {% endfor %}
</div>

`MonthArchiveView`¶

класс MonthArchiveView¶

Страница ежемесячного архива, показывающая все объекты за данный месяц. Объекты с датой в будущем не отображаются, если вы не установите allow_futureзначение True.

Предки (ТОиР)

Контекст

В дополнение к контексту, предоставленному MultipleObjectMixin(via BaseDateListView), контекст шаблона будет:

date_list: QuerySet Объект, содержащий все дни, в которых есть объекты, доступные в данном месяце, согласно queryset, представленные как datetime.datetime объекты, в порядке возрастания.
month: dateОбъект, представляющий данный месяц.
next_month: dateОбъект, представляющий первый день следующего месяца в соответствии с allow_emptyи allow_future.
previous_month: dateОбъект, представляющий первый день предыдущего месяца в соответствии с allow_emptyи allow_future.

Заметки

По умолчанию template_name_suffixиспользуется _archive_month.

Пример myapp / views.py :

from django.views.generic.dates import MonthArchiveView

from myapp.models import Article

class ArticleMonthArchiveView(MonthArchiveView):
    queryset = Article.objects.all()
    date_field = "pub_date"
    allow_future = True

Пример myapp / urls.py :

from django.urls import path

from myapp.views import ArticleMonthArchiveView

urlpatterns = [
    # Example: /2012/08/
    path('<int:year>/<int:month>/',
         ArticleMonthArchiveView.as_view(month_format='%m'),
         name="archive_month_numeric"),
    # Example: /2012/aug/
    path('<int:year>/<str:month>/',
         ArticleMonthArchiveView.as_view(),
         name="archive_month"),
]

Пример myapp / article_archive_month.html :

<ul>
    {% for article in object_list %}
        <li>{{ article.pub_date|date:"F j, Y" }}: {{ article.title }}</li>
    {% endfor %}
</ul>

<p>
    {% if previous_month %}
        Previous Month: {{ previous_month|date:"F Y" }}
    {% endif %}
    {% if next_month %}
        Next Month: {{ next_month|date:"F Y" }}
    {% endif %}
</p>

`WeekArchiveView`¶

класс WeekArchiveView¶

Страница еженедельного архива, показывающая все объекты за данную неделю. Объекты с датой в будущем не отображаются, если вы не установите allow_futureзначение True.

Предки (ТОиР)

Контекст

В дополнение к контексту, предоставленному MultipleObjectMixin(via BaseDateListView), контекст шаблона будет:

week: dateОбъект, представляющий первый день данной недели.
next_week: dateОбъект, представляющий первый день следующей недели в соответствии с allow_emptyи allow_future.
previous_week: dateОбъект, представляющий первый день предыдущей недели в соответствии с allow_emptyи allow_future.

Заметки

По умолчанию template_name_suffixиспользуется _archive_week.
week_formatАтрибут является strptime()строка формата используется для разбора номера недели. Поддерживаются следующие значения:
- '%U': На основе недельной системы США, в которой неделя начинается в воскресенье. Это значение по умолчанию.
- '%W': Аналогично '%U', но предполагает, что неделя начинается в понедельник. Это не то же самое, что номер недели ISO 8601.
- '%V': Номер недели ISO 8601, с которого неделя начинается в понедельник.
  
  Новое в Django 3.2:
  '%V'Добавлена поддержка формата недели.

Пример myapp / views.py :

from django.views.generic.dates import WeekArchiveView

from myapp.models import Article

class ArticleWeekArchiveView(WeekArchiveView):
    queryset = Article.objects.all()
    date_field = "pub_date"
    week_format = "%W"
    allow_future = True

Пример myapp / urls.py :

from django.urls import path

from myapp.views import ArticleWeekArchiveView

urlpatterns = [
    # Example: /2012/week/23/
    path('<int:year>/week/<int:week>/',
         ArticleWeekArchiveView.as_view(),
         name="archive_week"),
]

Пример myapp / article_archive_week.html :

<h1>Week {{ week|date:'W' }}</h1>

<ul>
    {% for article in object_list %}
        <li>{{ article.pub_date|date:"F j, Y" }}: {{ article.title }}</li>
    {% endfor %}
</ul>

<p>
    {% if previous_week %}
        Previous Week: {{ previous_week|date:"W" }} of year {{ previous_week|date:"Y" }}
    {% endif %}
    {% if previous_week and next_week %}--{% endif %}
    {% if next_week %}
        Next week: {{ next_week|date:"W" }} of year {{ next_week|date:"Y" }}
    {% endif %}
</p>

В этом примере вы выводите номер недели. Имейте в виду , что номера недель , вычисленные с помощью dateшаблона фильтра с 'W' характером формата не всегда совпадает с вычисленным по strftime()и strptime()с '%W'форматной строкой. Например, для 2015 года количество выпускаемых недель date на один больше, чем на strftime(). Для '%U' strftime()строки формата в формате date. Поэтому вам следует избегать использования dateдля генерации URL-адресов WeekArchiveView.

`DayArchiveView`¶

класс DayArchiveView¶

Страница дневного архива, показывающая все объекты за данный день. Дни в будущем вызывают ошибку 404 независимо от того, существуют ли какие-либо объекты для будущих дней, если вы не установите allow_futureзначение True.

Предки (ТОиР)

Контекст

В дополнение к контексту, предоставленному MultipleObjectMixin(via BaseDateListView), контекст шаблона будет:

day: dateОбъект, представляющий данный день.
next_day: dateОбъект, представляющий следующий день согласно allow_emptyи allow_future.
previous_day: dateОбъект, представляющий предыдущий день согласно allow_emptyи allow_future.
next_month: dateОбъект, представляющий первый день следующего месяца в соответствии с allow_emptyи allow_future.
previous_month: dateОбъект, представляющий первый день предыдущего месяца в соответствии с allow_emptyи allow_future.

Заметки

По умолчанию template_name_suffixиспользуется _archive_day.

Пример myapp / views.py :

from django.views.generic.dates import DayArchiveView

from myapp.models import Article

class ArticleDayArchiveView(DayArchiveView):
    queryset = Article.objects.all()
    date_field = "pub_date"
    allow_future = True

Пример myapp / urls.py :

from django.urls import path

from myapp.views import ArticleDayArchiveView

urlpatterns = [
    # Example: /2012/nov/10/
    path('<int:year>/<str:month>/<int:day>/',
         ArticleDayArchiveView.as_view(),
         name="archive_day"),
]

Пример myapp / article_archive_day.html :

<h1>{{ day }}</h1>

<ul>
    {% for article in object_list %}
        <li>{{ article.pub_date|date:"F j, Y" }}: {{ article.title }}</li>
    {% endfor %}
</ul>

<p>
    {% if previous_day %}
        Previous Day: {{ previous_day }}
    {% endif %}
    {% if previous_day and next_day %}--{% endif %}
    {% if next_day %}
        Next Day: {{ next_day }}
    {% endif %}
</p>

`TodayArchiveView`¶

класс TodayArchiveView¶

Страница дневного архива, показывающая все объекты на сегодня . Это точно так же django.views.generic.dates.DayArchiveView, за исключением того, что вместо аргументов year/ month/ используется сегодняшняя дата day.

Предки (ТОиР)

Заметки

По умолчанию template_name_suffixиспользуется _archive_today.

Пример myapp / views.py :

from django.views.generic.dates import TodayArchiveView

from myapp.models import Article

class ArticleTodayArchiveView(TodayArchiveView):
    queryset = Article.objects.all()
    date_field = "pub_date"
    allow_future = True

Пример myapp / urls.py :

from django.urls import path

from myapp.views import ArticleTodayArchiveView

urlpatterns = [
    path('today/',
         ArticleTodayArchiveView.as_view(),
         name="archive_today"),
]

Где образец шаблона TodayArchiveView?

Это представление по умолчанию использует тот же шаблон DayArchiveView, что и в предыдущем примере. Если вам нужен другой шаблон, установите в качестве template_nameатрибута имя нового шаблона.

`DateDetailView`¶

класс DateDetailView¶

Страница, представляющая отдельный объект. Если объект имеет значение даты в будущем, представление по умолчанию выдаст ошибку 404, если вы не установите allow_futureзначение True.

Предки (ТОиР)

Контекст

Включает единственный объект, связанный с modelуказанным в DateDetailView.

Заметки

По умолчанию template_name_suffixиспользуется _detail.

Пример myapp / urls.py :

from django.urls import path
from django.views.generic.dates import DateDetailView

urlpatterns = [
    path('<int:year>/<str:month>/<int:day>/<int:pk>/',
         DateDetailView.as_view(model=Article, date_field="pub_date"),
         name="archive_date_detail"),
]

Пример myapp / article_detail.html :

<h1>{{ object.title }}</h1>

Примечание

Все общие представления, перечисленные выше, имеют совпадающие Baseпредставления, которые отличаются только тем, что они не включают MultipleObjectTemplateResponseMixin (для архивных представлений) или SingleObjectTemplateResponseMixin (для DateDetailView):

класс BaseArchiveIndexView¶

класс BaseYearArchiveView¶

класс BaseMonthArchiveView¶

класс BaseWeekArchiveView¶

класс BaseDayArchiveView¶

класс BaseTodayArchiveView¶

класс BaseDateDetailView¶

Общие представления даты ¶

`ArchiveIndexView`¶

`YearArchiveView`¶

`MonthArchiveView`¶

`WeekArchiveView`¶

`DayArchiveView`¶

`TodayArchiveView`¶

`DateDetailView`¶

СОДЕРЖАНИЕ

Просматривать

Вы здесь:

Общие представления даты ¶ window.yaContextCb.push(()=>{ Ya.Context.AdvManager.render({ renderTo: 'yandex_rtb_R-A-2008230-3', blockId: 'R-A-2008230-3' }) })

ArchiveIndexView¶

YearArchiveView¶

MonthArchiveView¶

WeekArchiveView¶

DayArchiveView¶

TodayArchiveView¶

DateDetailView¶

СОДЕРЖАНИЕ

Просматривать

Вы здесь:

Общие представления даты ¶

`ArchiveIndexView`¶

`YearArchiveView`¶

`MonthArchiveView`¶

`WeekArchiveView`¶

`DayArchiveView`¶

`TodayArchiveView`¶

`DateDetailView`¶