mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-08-04 19:08:28 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

Fixed #28335 -- Allowed query expressions in Meta.ordering.

Browse source
This commit is contained in:
Dima Kudosh 2017-06-25 21:17:13 +03:00 • committed by Tim Graham
parent 3d2c3905a6
commit 093fd479d6
5 changed files with 37 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

18
docs/ref/models/options.txt
View file

@ -256,9 +256,10 @@ Django quotes column and table names behind the scenes.
ordering = ['-order_date']
This is a tuple or list of strings. Each string is a field name with an optional
"-" prefix, which indicates descending order. Fields without a leading "-" will
be ordered ascending. Use the string "?" to order randomly.
This is a tuple or list of strings and/or query expressions. Each string is
a field name with an optional "-" prefix, which indicates descending order.
Fields without a leading "-" will be ordered ascending. Use the string "?"
to order randomly.
For example, to order by a ``pub_date`` field ascending, use this::
@ -272,9 +273,20 @@ Django quotes column and table names behind the scenes.
ordering = ['-pub_date', 'author']
You can also use :doc:`query expressions </ref/models/expressions>`. To
order by ``author`` ascending and make null values sort last, use this::
from django.db.models import F
ordering = [F('author').asc(nulls_last=True)]
Default ordering also affects :ref:`aggregation queries
<aggregation-ordering-interaction>`.
.. versionchanged:: 2.0
Support for query expressions was added.
.. warning::
Ordering is not a free operation. Each field you add to the ordering