diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst index 09d368e4ee3..10678995eee 100644 --- 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`_ | @@ -150,10 +151,29 @@ 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`` + +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 ~~~~~~