Commit 9d52cdfb authored by Chad Shryock's avatar Chad Shryock Committed by Tim Graham
Browse files

[1.9.x] Fixed #26526 -- Documented QuerySet.latest()'s dependency on database ordering.

Backport of e6c5e68a from master
parent 95ed1514
Loading
Loading
Loading
Loading
+11 −0
Original line number Diff line number Diff line
@@ -1954,6 +1954,17 @@ given parameters.
Note that ``earliest()`` and ``latest()`` exist purely for convenience and
readability.

.. admonition:: ``earliest()`` and ``latest()`` may return instances with null dates.

    Since ordering is delegated to the database, results on fields that allow
    null values may be ordered differently if you use different databases. For
    example, PostgreSQL and MySQL sort null values as if they are higher than
    non-null values, while SQLite does the opposite.

    You may want to filter out null values::

        Entry.objects.filter(pub_date__isnull=False).latest('pub_date')

``earliest()``
~~~~~~~~~~~~~~