Fixed #24932 -- Added Cast database function.

Thanks Ian Foote for the initial patch.

2 files changed, 20 insertions, 0 deletions

diff --git a/docs/ref/models/database-functions.txt b/docs/ref/models/database-functions.txt
index 2bc95ff6e5..cd2d1ee368 100644
--- a/docs/ref/models/database-functions.txt
+++ b/docs/ref/models/database-functions.txt
@@ -23,6 +23,24 @@ We don't usually recommend allowing ``null=True`` for ``CharField`` since this
 allows the field to have two "empty values", but it's important for the
 ``Coalesce`` example below.
 
+``Cast``
+========
+
+.. class:: Cast(expression, output_field)
+
+.. versionadded:: 1.10
+
+Forces the result type of ``expression`` to be the one from ``output_field``.
+
+Usage example::
+
+    >>> from django.db.models import FloatField
+    >>> from django.db.models.functions import Cast
+    >>> Value.objects.create(integer=4)
+    >>> value = Value.objects.annotate(as_float=Cast('integer', FloatField)).get()
+    >>> print(value.as_float)
+    4.0
+
 ``Coalesce``
 ============
 
diff --git a/docs/releases/1.10.txt b/docs/releases/1.10.txt
index 48a262362e..1d253bfe62 100644
--- a/docs/releases/1.10.txt
+++ b/docs/releases/1.10.txt
@@ -349,6 +349,8 @@ Models
 * :meth:`QuerySet.bulk_create() <django.db.models.query.QuerySet.bulk_create>`
   sets the primary key on objects when using PostgreSQL.
 
+* Added the :class:`~django.db.models.functions.Cast` database function.
+
 Requests and Responses
 ~~~~~~~~~~~~~~~~~~~~~~