1
0
mirror of https://github.com/django/django.git synced 2024-12-26 19:16:11 +00:00
django/docs/ref/contrib/postgres/functions.txt

32 lines
1.0 KiB
Plaintext
Raw Normal View History

PostgreSQL specific database functions
======================================
All of these functions are available from the
``django.contrib.postgres.functions`` module.
.. currentmodule:: django.contrib.postgres.functions
TransactionNow
--------------
.. class:: TransactionNow()
.. versionadded:: 1.9
Returns the date and time on the database server that the current transaction
started. If you are not in a transaction it will return the date and time of
the current statement. This is a complement to
:class:`django.db.models.functions.Now`, which returns the date and time of the
current statement.
Note that only the outermost call to :func:`~django.db.transaction.atomic()`
sets up a transaction and thus sets the time that ``TransactionNow()`` will
return; nested calls create savepoints which do not affect the transaction
time.
Usage example::
>>> from django.contrib.postgres.functions import TransactionNow
>>> Article.objects.filter(published__lte=TransactionNow())
[<Article: How to Django>]