DQL custom functions: document TypedExpression

Partially related to doctrine#11537

Author: janedbal

docs/en/cookbook/dql-user-defined-functions.rst

@@ -232,6 +232,33 @@ vendors SQL parser to show us further errors in the parsing
 process, for example if the Unit would not be one of the supported
 values by MySql.
 
+Typed functions
+----------
+By default, result of custom functions is fetched as-is from the database driver.
+If you want to be sure the type is always the same, your custom function can 
+implement ``Doctrine\ORM\Query\AST\TypedExpression``. Then, the result is wired
+through ``convertToPhpValue`` method of the ``Type`` returned from ``getReturnType``.
+
+.. code-block:: php
+
+    <?php
+
+    use Doctrine\DBAL\Types\Type;
+    use Doctrine\DBAL\Types\Types;
+    use Doctrine\ORM\Query\AST\Functions\FunctionNode;
+    use Doctrine\ORM\Query\AST\TypedExpression;
+
+    class DateDiff extends FunctionNode implements TypedExpression
+    {
+        // ...
+
+        public function getReturnType(): Type
+        {
+            return Type::getType(Types::INTEGER);
+        }
+    }
+
+
 Conclusion
 ----------