Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Fixed #7546 -- Fixed an incorrect example in the docs that was mislea…

…ding some

people. Patch from Dan Watson.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@8232 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit 169b8894868555345a6fbaa885d7034e8dd1a16e 1 parent 90b6e14
@malcolmt malcolmt authored
Showing with 6 additions and 6 deletions.
  1. +6 −6 docs/db-api.txt
View
12 docs/db-api.txt
@@ -1708,8 +1708,8 @@ When you are filtering an object based on a ``ManyToManyField`` or a reverse
interested in. Consider the ``Blog``/``Entry`` relationship (``Blog`` to
``Entry`` is a one-to-many relation). We might be interested in finding blogs
that have an entry which has both *"Lennon"* in the headline and was published
-today. Or we might want to find blogs that have an entry with *"Lennon"* in
-the headline as well as an entry that was published today. Since there are
+in 2008. Or we might want to find blogs that have an entry with *"Lennon"* in
+the headline as well as an entry that was published in 2008. Since there are
multiple entries associated with a single ``Blog``, both of these queries are
possible and make sense in some situations.
@@ -1728,16 +1728,16 @@ earlier ``filter()`` call.
That may sound a bit confusing, so hopefully an example will clarify. To
select all blogs that contains entries with *"Lennon"* in the headline and
-were published today, we would write::
+were published in 2008, we would write::
Blog.objects.filter(entry__headline__contains='Lennon',
- entry__pub_date=datetime.date.today())
+ entry__pub_date__year=2008)
To select all blogs that contain an entry with *"Lennon"* in the headline
-**as well as** an entry that was published today, we would write::
+**as well as** an entry that was published in 2008, we would write::
Blog.objects.filter(entry__headline__contains='Lennon').filter(
- entry__pub_date=datetime.date.today())
+ entry__pub_date__year=2008)
In this second example, the first filter restricted the queryset to all those
blogs linked to that particular type of entry. The second filter restricted
Please sign in to comment.
Something went wrong with that request. Please try again.