[MERGE] forward port branch saas-11.3 up to 1e0a92c9962

1 files changed, 12 insertions, 0 deletions

diff --git a/doc/reference/views.rst b/doc/reference/views.rst
index cbb85b71c83..50f11f4173e 100644
--- a/doc/reference/views.rst
+++ b/doc/reference/views.rst
@@ -823,6 +823,18 @@ element is ``<pivot>`` which can take the following attributes:
 
 The elements allowed within a pivot view are the same as for the graph view.
 
+In Pivot view a ``field`` can have a ``widget`` attribute to dictate its format.
+The widget should be a field formatter, of which the most interesting are
+``date``, ``datetime``, ``float_time``, and ``monetary``.
+
+For instance a timesheet pivot view could be defined as::
+
+    <pivot string="Timesheet">
+        <field name="employee_id" type="row"/>
+        <field name="date" interval="month" type="col"/>
+        <field name="unit_amount" type="measure" widget="float_time"/>
+    </pivot>
+
 .. _reference/views/kanban:
 
 Kanban