Merge branch '4.4' into 5.0

javiereguiluz · javiereguiluz · commit 43445da11888 · 2020-03-24T12:09:57.000+01:00
* 4.4:
  document the reference_date option
diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
@@ -23,6 +23,7 @@ stored as a ``DateTime`` object, a string, a timestamp or an array.
 |                      | - `input_format`_                                                           |
 |                      | - `minutes`_                                                                |
 |                      | - `model_timezone`_                                                         |
+|                      | - `reference_date`_                                                         |
 |                      | - `seconds`_                                                                |
 |                      | - `view_timezone`_                                                          |
 |                      | - `widget`_                                                                 |
@@ -146,10 +147,33 @@ of the time. This must be a valid `PHP time format`_.
 
 .. include:: /reference/forms/types/options/model_timezone.rst.inc
 
+.. caution::
+
+    When using different values for ``model_timezone`` and `view_timezone`_,
+    a `reference_date`_ must be configured.
+
+reference_date
+~~~~~~~~~~~~~~
+
+**type**: ``DateTimeInterface`` **default**: ``null``
+
+.. versionadded:: 4.4
+
+    The ``reference_date`` option was introduced in Symfony 4.4.
+
+Configuring a reference date is required when the `model_timezone`_ and
+`view_timezone`_ are different. Timezone conversions will be calculated
+based on this date.
+
 .. include:: /reference/forms/types/options/seconds.rst.inc
 
 .. include:: /reference/forms/types/options/view_timezone.rst.inc
 
+.. caution::
+
+    When using different values for `model_timezone`_ and ``view_timezone``,
+    a `reference_date`_ must be configured.
+
 widget
 ~~~~~~
 
