Loading docs/ref/class-based-views/generic-date-based.txt +10 −16 Original line number Diff line number Diff line Loading @@ -48,11 +48,9 @@ ArchiveIndexView :class:`django.views.generic.dates.BaseDateListView`), the template's context will be: * ``date_list``: A :meth:`DateQuerySet<django.db.models.query.QuerySet.dates>` object containing all years that have objects available according to ``queryset``, represented as :class:`datetime.datetime<python:datetime.datetime>` objects, in * ``date_list``: A :meth:`QuerySet <django.db.models.query.QuerySet.dates>` object containing all years that have objects available according to ``queryset``, represented as :class:`datetime.datetime` objects, in descending order. **Notes** Loading Loading @@ -128,11 +126,9 @@ YearArchiveView :class:`django.views.generic.dates.BaseDateListView`), the template's context will be: * ``date_list``: A :meth:`DateQuerySet<django.db.models.query.QuerySet.dates>` object containing all months that have objects available according to ``queryset``, represented as :class:`datetime.datetime<python:datetime.datetime>` objects, in * ``date_list``: A :meth:`QuerySet <django.db.models.query.QuerySet.dates>` object containing all months that have objects available according to ``queryset``, represented as :class:`datetime.datetime` objects, in ascending order. * ``year``: A :class:`~datetime.date` object Loading Loading @@ -223,12 +219,10 @@ MonthArchiveView :class:`~django.views.generic.dates.BaseDateListView`), the template's context will be: * ``date_list``: A :meth:`DateQuerySet<django.db.models.query.QuerySet.dates>` object containing all days that have objects available in the given month, according to ``queryset``, represented as :class:`datetime.datetime<python:datetime.datetime>` objects, in ascending order. * ``date_list``: A :meth:`QuerySet <django.db.models.query.QuerySet.dates>` object containing all days that have objects available in the given month, according to ``queryset``, represented as :class:`datetime.datetime` objects, in ascending order. * ``month``: A :class:`~datetime.date` object representing the given month. Loading docs/ref/models/querysets.txt +3 −3 Original line number Diff line number Diff line Loading @@ -646,9 +646,9 @@ dates .. method:: dates(field, kind, order='ASC') Returns a ``DateQuerySet`` — a ``QuerySet`` that evaluates to a list of :class:`datetime.date` objects representing all available dates of a particular kind within the contents of the ``QuerySet``. Returns a ``QuerySet`` that evaluates to a list of :class:`datetime.date` objects representing all available dates of a particular kind within the contents of the ``QuerySet``. ``field`` should be the name of a ``DateField`` of your model. ``kind`` should be either ``"year"``, ``"month"`` or ``"day"``. Each Loading tests/aggregation_regress/tests.py +1 −1 Original line number Diff line number Diff line Loading @@ -670,7 +670,7 @@ class AggregationTests(TestCase): lambda b: b.name ) # Regression for #10248 - Annotations work with DateQuerySets # Regression for #10248 - Annotations work with dates() qs = Book.objects.annotate(num_authors=Count('authors')).filter(num_authors=2).dates('pubdate', 'day') self.assertQuerysetEqual( qs, [ Loading tests/queries/tests.py +3 −3 Original line number Diff line number Diff line Loading @@ -751,7 +751,7 @@ class Queries1Tests(BaseQuerysetTest): 3 ) # Pickling of DateQuerySets used to fail # Pickling of QuerySets using datetimes() should work. qs = Item.objects.datetimes('created', 'month') pickle.loads(pickle.dumps(qs)) Loading Loading @@ -1302,8 +1302,8 @@ class Queries3Tests(BaseQuerysetTest): self.assertQuerysetEqual(Valid.objects.all(), []) def test_ticket8683(self): # Raise proper error when a DateQuerySet gets passed a wrong type of # field # An error should be raised when QuerySet.datetimes() is passed the # wrong type of field. self.assertRaisesMessage( AssertionError, "'name' isn't a DateTimeField.", Loading Loading
docs/ref/class-based-views/generic-date-based.txt +10 −16 Original line number Diff line number Diff line Loading @@ -48,11 +48,9 @@ ArchiveIndexView :class:`django.views.generic.dates.BaseDateListView`), the template's context will be: * ``date_list``: A :meth:`DateQuerySet<django.db.models.query.QuerySet.dates>` object containing all years that have objects available according to ``queryset``, represented as :class:`datetime.datetime<python:datetime.datetime>` objects, in * ``date_list``: A :meth:`QuerySet <django.db.models.query.QuerySet.dates>` object containing all years that have objects available according to ``queryset``, represented as :class:`datetime.datetime` objects, in descending order. **Notes** Loading Loading @@ -128,11 +126,9 @@ YearArchiveView :class:`django.views.generic.dates.BaseDateListView`), the template's context will be: * ``date_list``: A :meth:`DateQuerySet<django.db.models.query.QuerySet.dates>` object containing all months that have objects available according to ``queryset``, represented as :class:`datetime.datetime<python:datetime.datetime>` objects, in * ``date_list``: A :meth:`QuerySet <django.db.models.query.QuerySet.dates>` object containing all months that have objects available according to ``queryset``, represented as :class:`datetime.datetime` objects, in ascending order. * ``year``: A :class:`~datetime.date` object Loading Loading @@ -223,12 +219,10 @@ MonthArchiveView :class:`~django.views.generic.dates.BaseDateListView`), the template's context will be: * ``date_list``: A :meth:`DateQuerySet<django.db.models.query.QuerySet.dates>` object containing all days that have objects available in the given month, according to ``queryset``, represented as :class:`datetime.datetime<python:datetime.datetime>` objects, in ascending order. * ``date_list``: A :meth:`QuerySet <django.db.models.query.QuerySet.dates>` object containing all days that have objects available in the given month, according to ``queryset``, represented as :class:`datetime.datetime` objects, in ascending order. * ``month``: A :class:`~datetime.date` object representing the given month. Loading
docs/ref/models/querysets.txt +3 −3 Original line number Diff line number Diff line Loading @@ -646,9 +646,9 @@ dates .. method:: dates(field, kind, order='ASC') Returns a ``DateQuerySet`` — a ``QuerySet`` that evaluates to a list of :class:`datetime.date` objects representing all available dates of a particular kind within the contents of the ``QuerySet``. Returns a ``QuerySet`` that evaluates to a list of :class:`datetime.date` objects representing all available dates of a particular kind within the contents of the ``QuerySet``. ``field`` should be the name of a ``DateField`` of your model. ``kind`` should be either ``"year"``, ``"month"`` or ``"day"``. Each Loading
tests/aggregation_regress/tests.py +1 −1 Original line number Diff line number Diff line Loading @@ -670,7 +670,7 @@ class AggregationTests(TestCase): lambda b: b.name ) # Regression for #10248 - Annotations work with DateQuerySets # Regression for #10248 - Annotations work with dates() qs = Book.objects.annotate(num_authors=Count('authors')).filter(num_authors=2).dates('pubdate', 'day') self.assertQuerysetEqual( qs, [ Loading
tests/queries/tests.py +3 −3 Original line number Diff line number Diff line Loading @@ -751,7 +751,7 @@ class Queries1Tests(BaseQuerysetTest): 3 ) # Pickling of DateQuerySets used to fail # Pickling of QuerySets using datetimes() should work. qs = Item.objects.datetimes('created', 'month') pickle.loads(pickle.dumps(qs)) Loading Loading @@ -1302,8 +1302,8 @@ class Queries3Tests(BaseQuerysetTest): self.assertQuerysetEqual(Valid.objects.all(), []) def test_ticket8683(self): # Raise proper error when a DateQuerySet gets passed a wrong type of # field # An error should be raised when QuerySet.datetimes() is passed the # wrong type of field. self.assertRaisesMessage( AssertionError, "'name' isn't a DateTimeField.", Loading