summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/models/database-functions.txt11
1 files changed, 11 insertions, 0 deletions
diff --git a/docs/ref/models/database-functions.txt b/docs/ref/models/database-functions.txt
index cdd46ff1a2..717dc94cbf 100644
--- a/docs/ref/models/database-functions.txt
+++ b/docs/ref/models/database-functions.txt
@@ -55,6 +55,17 @@ Usage examples::
>>> print(aggregated['combined_age_default'])
None
+.. warning::
+
+ A python value passed to ``Coalesce`` on MySQL may be converted to an
+ incorrect type unless explicitly cast to the correct database type:
+
+ >>> from django.db.models.expressions import RawSQL
+ >>> from django.utils import timezone
+ >>> now = timezone.now()
+ >>> now_sql = RawSQL("cast(%s as datetime)", (now,))
+ >>> Coalesce('updated', now_sql)
+
Concat
------