[1.10.x] Fixed #25475 -- Doc'd how to use a literal % in Func.template.

Backport of c60feb6999 from master
This commit is contained in:
Tim Graham 2016-10-07 10:24:45 -04:00
parent 08650ab741
commit be535960b1
1 changed files with 6 additions and 0 deletions

View File

@ -263,6 +263,12 @@ The ``Func`` API is as follows:
generated for this function. Defaults to
``'%(function)s(%(expressions)s)'``.
If you're constructing SQL like ``strftime('%W', 'date')`` and need a
literal ``%`` character in the query, quadruple it (``%%%%``) in the
``template`` attribute because the string is interpolated twice: once
during the template interpolation in ``as_sql()`` and once in the SQL
interpolation with the query parameters in the database cursor.
.. attribute:: arg_joiner
A class attribute that denotes the character used to join the list of