Document that Q objects can be used directly in annotations

[Laurent Bergeron]

I needed to annotate something to a queryset and found a solution that looked like this:

queryset = MyModel.objects.annotate(
    created_less_than_hour_ago=Q(time_of_creation__gt=(now() - timedelta(hours=1)))
)

It worked fine and "created_less_than_hour_ago" was set to True if the object was created less than an hour ago and to False otherwise. I found another way to achieve this though because I didn't find any documentation about the use of Q objects inside of the annotate method, so I couldn't understand why and how it worked.

So, here I am asking for documentation about it.

[Sarah Boyce]

I believe support for this was implemented in #27021
I agree that we could add something in the documentation specific for Q objects

[Lufafa Joshua]

​PR

[Samruddhi Dharankar]

Hi, I'm not sure if work is still being done on this. But I submitted a ​PR for the requested changes.

[Sarah Boyce <42296566+sarahboyce@…>]

In 9120a19:

Fixed #36066 -- Documented that Q objects can be used directly in annotations.

[Sarah Boyce <42296566+sarahboyce@…>]

In 930d9c2:

[5.2.x] Fixed #36066 -- Documented that Q objects can be used directly in annotations.

Backport of 9120a19c4ecb643111b073dd1069e6b410a03c23 from main.

[Sarah Boyce <42296566+sarahboyce@…>]

In ccd5867a:

[5.1.x] Fixed #36066 -- Documented that Q objects can be used directly in annotations.

Backport of 9120a19c4ecb643111b073dd1069e6b410a03c23 from main.