---
title: "Generic date views"
version: 1.8
locale: en
source: https://docs.djangoproject.com/en/1.8/ref/class-based-views/generic-date-based/
canonical: https://djangodocs.dev/en/1.8/ref/class-based-views/generic-date-based/
---
# Generic date views

Date-based generic views, provided in [`django.views.generic.dates`](#module-django.views.generic.dates), are
views for displaying drilldown pages for date-based data.

> **Note**
>
> Some of the examples on this page assume that an `Article` model has been
> defined as follows in `myapp/models.py`:
>
> ```
> from django.db import models
> from django.core.urlresolvers import reverse
>
> class Article(models.Model):
>     title = models.CharField(max_length=200)
>     pub_date = models.DateField()
>
>     def get_absolute_url(self):
>         return reverse('article-detail', kwargs={'pk': self.pk})
> ```

## ArchiveIndexView

#### `class ArchiveIndexView`

A top-level index page showing the “latest” objects, by date. Objects with
a date in the *future* are not included unless you set `allow_future` to
`True`.

**Ancestors (MRO)**

- [`django.views.generic.list.MultipleObjectTemplateResponseMixin`](/en/1.8/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectTemplateResponseMixin)
- [`django.views.generic.base.TemplateResponseMixin`](/en/1.8/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin)
- [`django.views.generic.dates.BaseArchiveIndexView`](#django.views.generic.dates.BaseArchiveIndexView)
- [`django.views.generic.dates.BaseDateListView`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView)
- [`django.views.generic.list.MultipleObjectMixin`](/en/1.8/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin)
- [`django.views.generic.dates.DateMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DateMixin)
- [`django.views.generic.base.View`](/en/1.8/ref/class-based-views/base/#django.views.generic.base.View)

**Context**

In addition to the context provided by
[`django.views.generic.list.MultipleObjectMixin`](/en/1.8/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin) (via
[`django.views.generic.dates.BaseDateListView`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView)), the template’s
context will be:

- `date_list`: A [`QuerySet`](/en/1.8/ref/models/querysets/#django.db.models.query.QuerySet.dates)
  object containing all years that have objects available according to
  `queryset`, represented as [`datetime.datetime`](https://docs.python.org/3/library/datetime.html#datetime.datetime) objects, in
  descending order.

**Notes**

- Uses a default `context_object_name` of `latest`.
- Uses a default `template_name_suffix` of `_archive`.
- Defaults to providing `date_list` by year, but this can be altered to
  month or day using the attribute `date_list_period`. This also applies
  to all subclass views.

**Example myapp/urls.py**:

```
from django.conf.urls import url
from django.views.generic.dates import ArchiveIndexView

from myapp.models import Article

urlpatterns = [
    url(r'^archive/$',
        ArchiveIndexView.as_view(model=Article, date_field="pub_date"),
        name="article_archive"),
]
```

**Example myapp/article\_archive.html**:

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

This will output all articles.

## YearArchiveView

#### `class YearArchiveView`

A yearly archive page showing all available months in a given year. Objects
with a date in the *future* are not displayed unless you set
`allow_future` to `True`.

**Ancestors (MRO)**

- [`django.views.generic.list.MultipleObjectTemplateResponseMixin`](/en/1.8/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectTemplateResponseMixin)
- [`django.views.generic.base.TemplateResponseMixin`](/en/1.8/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin)
- [`django.views.generic.dates.BaseYearArchiveView`](#django.views.generic.dates.BaseYearArchiveView)
- [`django.views.generic.dates.YearMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.YearMixin)
- [`django.views.generic.dates.BaseDateListView`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView)
- [`django.views.generic.list.MultipleObjectMixin`](/en/1.8/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin)
- [`django.views.generic.dates.DateMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DateMixin)
- [`django.views.generic.base.View`](/en/1.8/ref/class-based-views/base/#django.views.generic.base.View)

#### `make_object_list`

A boolean specifying whether to retrieve the full list of objects for
this year and pass those to the template. If `True`, the list of
objects will be made available to the context. If `False`, the
`None` queryset will be used as the object list. By default, this is
`False`.

#### `get_make_object_list()`

Determine if an object list will be returned as part of the context.
Returns [`make_object_list`](#django.views.generic.dates.YearArchiveView.make_object_list) by default.

**Context**

In addition to the context provided by
[`django.views.generic.list.MultipleObjectMixin`](/en/1.8/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin) (via
[`django.views.generic.dates.BaseDateListView`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView)), the template’s
context will be:

- `date_list`: A [`QuerySet`](/en/1.8/ref/models/querysets/#django.db.models.query.QuerySet.dates)
  object containing all months that have objects available according to
  `queryset`, represented as [`datetime.datetime`](https://docs.python.org/3/library/datetime.html#datetime.datetime) objects, in
  ascending order.
- `year`: A [`date`](https://docs.python.org/3/library/datetime.html#datetime.date) object
  representing the given year.
- `next_year`: A [`date`](https://docs.python.org/3/library/datetime.html#datetime.date) object
  representing the first day of the next year, according to
  [`allow_empty`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView.allow_empty) and
  [`allow_future`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DateMixin.allow_future).
- `previous_year`: A [`date`](https://docs.python.org/3/library/datetime.html#datetime.date) object
  representing the first day of the previous year, according to
  [`allow_empty`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView.allow_empty) and
  [`allow_future`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DateMixin.allow_future).

**Notes**

- Uses a default `template_name_suffix` of `_archive_year`.

**Example 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
```

**Example myapp/urls.py**:

```
from django.conf.urls import url

from myapp.views import ArticleYearArchiveView

urlpatterns = [
    url(r'^(?P<year>[0-9]{4})/$',
        ArticleYearArchiveView.as_view(),
        name="article_year_archive"),
]
```

**Example myapp/article\_archive\_year.html**:

```html+django
<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

#### `class MonthArchiveView`

A monthly archive page showing all objects in a given month. Objects with a
date in the *future* are not displayed unless you set `allow_future` to
`True`.

**Ancestors (MRO)**

- [`django.views.generic.list.MultipleObjectTemplateResponseMixin`](/en/1.8/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectTemplateResponseMixin)
- [`django.views.generic.base.TemplateResponseMixin`](/en/1.8/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin)
- [`django.views.generic.dates.BaseMonthArchiveView`](#django.views.generic.dates.BaseMonthArchiveView)
- [`django.views.generic.dates.YearMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.YearMixin)
- [`django.views.generic.dates.MonthMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.MonthMixin)
- [`django.views.generic.dates.BaseDateListView`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView)
- [`django.views.generic.list.MultipleObjectMixin`](/en/1.8/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin)
- [`django.views.generic.dates.DateMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DateMixin)
- [`django.views.generic.base.View`](/en/1.8/ref/class-based-views/base/#django.views.generic.base.View)

**Context**

In addition to the context provided by
[`MultipleObjectMixin`](/en/1.8/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin) (via
[`BaseDateListView`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView)), the template’s
context will be:

- `date_list`: A [`QuerySet`](/en/1.8/ref/models/querysets/#django.db.models.query.QuerySet.dates)
  object containing all days that have objects available in the given month,
  according to `queryset`, represented as [`datetime.datetime`](https://docs.python.org/3/library/datetime.html#datetime.datetime)
  objects, in ascending order.
- `month`: A [`date`](https://docs.python.org/3/library/datetime.html#datetime.date) object
  representing the given month.
- `next_month`: A [`date`](https://docs.python.org/3/library/datetime.html#datetime.date) object
  representing the first day of the next month, according to
  [`allow_empty`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView.allow_empty) and
  [`allow_future`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DateMixin.allow_future).
- `previous_month`: A [`date`](https://docs.python.org/3/library/datetime.html#datetime.date) object
  representing the first day of the previous month, according to
  [`allow_empty`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView.allow_empty) and
  [`allow_future`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DateMixin.allow_future).

**Notes**

- Uses a default `template_name_suffix` of `_archive_month`.

**Example 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
```

**Example myapp/urls.py**:

```
from django.conf.urls import url

from myapp.views import ArticleMonthArchiveView

urlpatterns = [
    # Example: /2012/aug/
    url(r'^(?P<year>[0-9]{4})/(?P<month>[-\w]+)/$',
        ArticleMonthArchiveView.as_view(),
        name="archive_month"),
    # Example: /2012/08/
    url(r'^(?P<year>[0-9]{4})/(?P<month>[0-9]+)/$',
        ArticleMonthArchiveView.as_view(month_format='%m'),
        name="archive_month_numeric"),
]
```

**Example myapp/article\_archive\_month.html**:

```html+django
<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

#### `class WeekArchiveView`

A weekly archive page showing all objects in a given week. Objects with a
date in the *future* are not displayed unless you set `allow_future` to
`True`.

**Ancestors (MRO)**

- [`django.views.generic.list.MultipleObjectTemplateResponseMixin`](/en/1.8/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectTemplateResponseMixin)
- [`django.views.generic.base.TemplateResponseMixin`](/en/1.8/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin)
- [`django.views.generic.dates.BaseWeekArchiveView`](#django.views.generic.dates.BaseWeekArchiveView)
- [`django.views.generic.dates.YearMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.YearMixin)
- [`django.views.generic.dates.WeekMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.WeekMixin)
- [`django.views.generic.dates.BaseDateListView`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView)
- [`django.views.generic.list.MultipleObjectMixin`](/en/1.8/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin)
- [`django.views.generic.dates.DateMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DateMixin)
- [`django.views.generic.base.View`](/en/1.8/ref/class-based-views/base/#django.views.generic.base.View)

**Context**

In addition to the context provided by
[`MultipleObjectMixin`](/en/1.8/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin) (via
[`BaseDateListView`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView)), the template’s
context will be:

- `week`: A [`date`](https://docs.python.org/3/library/datetime.html#datetime.date) object
  representing the first day of the given week.
- `next_week`: A [`date`](https://docs.python.org/3/library/datetime.html#datetime.date) object
  representing the first day of the next week, according to
  [`allow_empty`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView.allow_empty) and
  [`allow_future`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DateMixin.allow_future).
- `previous_week`: A [`date`](https://docs.python.org/3/library/datetime.html#datetime.date) object
  representing the first day of the previous week, according to
  [`allow_empty`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView.allow_empty) and
  [`allow_future`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DateMixin.allow_future).

**Notes**

- Uses a default `template_name_suffix` of `_archive_week`.

**Example 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
```

**Example myapp/urls.py**:

```
from django.conf.urls import url

from myapp.views import ArticleWeekArchiveView

urlpatterns = [
    # Example: /2012/week/23/
    url(r'^(?P<year>[0-9]{4})/week/(?P<week>[0-9]+)/$',
        ArticleWeekArchiveView.as_view(),
        name="archive_week"),
]
```

**Example myapp/article\_archive\_week.html**:

```html+django
<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:"F Y" }}
    {% endif %}
    {% if previous_week and next_week %}--{% endif %}
    {% if next_week %}
        Next week: {{ next_week|date:"F Y" }}
    {% endif %}
</p>
```

In this example, you are outputting the week number. The default
`week_format` in the `WeekArchiveView` uses  week format `'%U'`
which is based on the United States week system where the week begins on a
Sunday. The `'%W'` format uses the ISO week format and its week
begins on a Monday.  The `'%W'` format is the same in both the
[`strftime()`](https://docs.python.org/3/library/time.html#time.strftime) and the [`date`](/en/1.8/ref/templates/builtins/#std-templatefilter-date).

However, the [`date`](/en/1.8/ref/templates/builtins/#std-templatefilter-date) template filter does not have an equivalent
output format that supports the US based week system. The [`date`](/en/1.8/ref/templates/builtins/#std-templatefilter-date)
filter `'%U'` outputs the number of seconds since the Unix epoch.

## DayArchiveView

#### `class DayArchiveView`

A day archive page showing all objects in a given day. Days in the future
throw a 404 error, regardless of whether any objects exist for future days,
unless you set `allow_future` to `True`.

**Ancestors (MRO)**

- [`django.views.generic.list.MultipleObjectTemplateResponseMixin`](/en/1.8/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectTemplateResponseMixin)
- [`django.views.generic.base.TemplateResponseMixin`](/en/1.8/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin)
- [`django.views.generic.dates.BaseDayArchiveView`](#django.views.generic.dates.BaseDayArchiveView)
- [`django.views.generic.dates.YearMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.YearMixin)
- [`django.views.generic.dates.MonthMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.MonthMixin)
- [`django.views.generic.dates.DayMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DayMixin)
- [`django.views.generic.dates.BaseDateListView`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView)
- [`django.views.generic.list.MultipleObjectMixin`](/en/1.8/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin)
- [`django.views.generic.dates.DateMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DateMixin)
- [`django.views.generic.base.View`](/en/1.8/ref/class-based-views/base/#django.views.generic.base.View)

**Context**

In addition to the context provided by
[`MultipleObjectMixin`](/en/1.8/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin) (via
[`BaseDateListView`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView)), the template’s
context will be:

- `day`: A [`date`](https://docs.python.org/3/library/datetime.html#datetime.date) object
  representing the given day.
- `next_day`: A [`date`](https://docs.python.org/3/library/datetime.html#datetime.date) object
  representing the next day, according to
  [`allow_empty`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView.allow_empty) and
  [`allow_future`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DateMixin.allow_future).
- `previous_day`: A [`date`](https://docs.python.org/3/library/datetime.html#datetime.date) object
  representing the previous day, according to
  [`allow_empty`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView.allow_empty) and
  [`allow_future`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DateMixin.allow_future).
- `next_month`: A [`date`](https://docs.python.org/3/library/datetime.html#datetime.date) object
  representing the first day of the next month, according to
  [`allow_empty`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView.allow_empty) and
  [`allow_future`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DateMixin.allow_future).
- `previous_month`: A [`date`](https://docs.python.org/3/library/datetime.html#datetime.date) object
  representing the first day of the previous month, according to
  [`allow_empty`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView.allow_empty) and
  [`allow_future`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DateMixin.allow_future).

**Notes**

- Uses a default `template_name_suffix` of `_archive_day`.

**Example 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
```

**Example myapp/urls.py**:

```
from django.conf.urls import url

from myapp.views import ArticleDayArchiveView

urlpatterns = [
    # Example: /2012/nov/10/
    url(r'^(?P<year>[0-9]{4})/(?P<month>[-\w]+)/(?P<day>[0-9]+)/$',
        ArticleDayArchiveView.as_view(),
        name="archive_day"),
]
```

**Example myapp/article\_archive\_day.html**:

```html+django
<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

#### `class TodayArchiveView`

A day archive page showing all objects for *today*. This is exactly the
same as [`django.views.generic.dates.DayArchiveView`](#django.views.generic.dates.DayArchiveView), except today’s
date is used instead of the `year`/`month`/`day` arguments.

**Ancestors (MRO)**

- [`django.views.generic.list.MultipleObjectTemplateResponseMixin`](/en/1.8/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectTemplateResponseMixin)
- [`django.views.generic.base.TemplateResponseMixin`](/en/1.8/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin)
- [`django.views.generic.dates.BaseTodayArchiveView`](#django.views.generic.dates.BaseTodayArchiveView)
- [`django.views.generic.dates.BaseDayArchiveView`](#django.views.generic.dates.BaseDayArchiveView)
- [`django.views.generic.dates.YearMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.YearMixin)
- [`django.views.generic.dates.MonthMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.MonthMixin)
- [`django.views.generic.dates.DayMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DayMixin)
- [`django.views.generic.dates.BaseDateListView`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.BaseDateListView)
- [`django.views.generic.list.MultipleObjectMixin`](/en/1.8/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin)
- [`django.views.generic.dates.DateMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DateMixin)
- [`django.views.generic.base.View`](/en/1.8/ref/class-based-views/base/#django.views.generic.base.View)

**Notes**

- Uses a default `template_name_suffix` of `_archive_today`.

**Example 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
```

**Example myapp/urls.py**:

```
from django.conf.urls import url

from myapp.views import ArticleTodayArchiveView

urlpatterns = [
    url(r'^today/$',
        ArticleTodayArchiveView.as_view(),
        name="archive_today"),
]
```

> **Where is the example template for TodayArchiveView?**
>
> This view uses by default the same template as the
> [`DayArchiveView`](/en/1.8/ref/class-based-views/flattened-index/#DayArchiveView), which is in the previous example. If you need
> a different template, set the `template_name` attribute to be the
> name of the new template.

## DateDetailView

#### `class DateDetailView`

A page representing an individual object. If the object has a date value in
the future, the view will throw a 404 error by default, unless you set
`allow_future` to `True`.

**Ancestors (MRO)**

- [`django.views.generic.detail.SingleObjectTemplateResponseMixin`](/en/1.8/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectTemplateResponseMixin)
- [`django.views.generic.base.TemplateResponseMixin`](/en/1.8/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin)
- [`django.views.generic.dates.BaseDateDetailView`](#django.views.generic.dates.BaseDateDetailView)
- [`django.views.generic.dates.YearMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.YearMixin)
- [`django.views.generic.dates.MonthMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.MonthMixin)
- [`django.views.generic.dates.DayMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DayMixin)
- [`django.views.generic.dates.DateMixin`](/en/1.8/ref/class-based-views/mixins-date-based/#django.views.generic.dates.DateMixin)
- `django.views.generic.detail.BaseDetailView`
- [`django.views.generic.detail.SingleObjectMixin`](/en/1.8/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectMixin)
- [`django.views.generic.base.View`](/en/1.8/ref/class-based-views/base/#django.views.generic.base.View)

**Context**

- Includes the single object associated with the `model` specified in
  the `DateDetailView`.

**Notes**

- Uses a default `template_name_suffix` of `_detail`.

**Example myapp/urls.py**:

```
from django.conf.urls import url
from django.views.generic.dates import DateDetailView

urlpatterns = [
    url(r'^(?P<year>[0-9]{4})/(?P<month>[-\w]+)/(?P<day>[0-9]+)/(?P<pk>[0-9]+)/$',
        DateDetailView.as_view(model=Article, date_field="pub_date"),
        name="archive_date_detail"),
]
```

**Example myapp/article\_detail.html**:

```html+django
<h1>{{ object.title }}</h1>
```

> **Note**
>
> All of the generic views listed above have matching `Base` views that
> only differ in that they do not include the
> [`MultipleObjectTemplateResponseMixin`](/en/1.8/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectTemplateResponseMixin)
> (for the archive views) or
> [`SingleObjectTemplateResponseMixin`](/en/1.8/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectTemplateResponseMixin)
> (for the [`DateDetailView`](/en/1.8/ref/class-based-views/flattened-index/#DateDetailView)):
>
> #### `class BaseArchiveIndexView`
>
>
>
>
> #### `class BaseYearArchiveView`
>
>
>
>
> #### `class BaseMonthArchiveView`
>
>
>
>
> #### `class BaseWeekArchiveView`
>
>
>
>
> #### `class BaseDayArchiveView`
>
>
>
>
> #### `class BaseTodayArchiveView`
>
>
>
>
> #### `class BaseDateDetailView`
