Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
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

0 comments on commit 169b889

Please sign in to comment.
Something went wrong with that request. Please try again.