Permalink
Browse files

[Reference][Form Types] Document "with_minutes" time/datetime option

  • Loading branch information...
bicpi committed Jan 6, 2014
1 parent 0428c57 commit 8cfb85095878f51dea0dfdbca59bf21e1c15a399
@@ -26,6 +26,7 @@ data can be a ``DateTime`` object, a string, a timestamp or an array.
| | - `years`_ |
| | - `months`_ |
| | - `days`_ |
| | - `with_minutes`_ |
| | - `with_seconds`_ |
| | - `model_timezone`_ |
| | - `view_timezone`_ |
@@ -109,6 +110,8 @@ for more details.
.. include:: /reference/forms/types/options/days.rst.inc
.. include:: /reference/forms/types/options/with_minutes.rst.inc
.. include:: /reference/forms/types/options/with_seconds.rst.inc
.. include:: /reference/forms/types/options/model_timezone.rst.inc
@@ -0,0 +1,10 @@
with_minutes
~~~~~~~~~~~~
**type**: ``Boolean`` **default**: ``true``
Whether or not to include minutes in the input. This will result in an additional
input to capture minutes.
.. versionadded:: 2.2
The ``with_minutes`` option was introduced in Symfony 2.2.
@@ -17,6 +17,7 @@ as a ``DateTime`` object, a string, a timestamp or an array.
+----------------------+-----------------------------------------------------------------------------+
| Options | - `widget`_ |
| | - `input`_ |
| | - `with_minutes`_ |
| | - `with_seconds`_ |
| | - `hours`_ |
| | - `minutes`_ |
@@ -83,13 +84,21 @@ widget
The basic way in which this field should be rendered. Can be one of the following:
* ``choice``: renders two (or three if `with_seconds`_ is true) select inputs.
* ``choice``: renders one, two (default) or three select inputs (hour, minute,
second), depending on the `with_minutes`_ and `with_seconds`_ options.
* ``text``: renders a two or three text inputs (hour, minute, second).
* ``text``: renders one, two (default) or three text inputs (hour, minute,
second), depending on the `with_minutes`_ and `with_seconds`_ options.
* ``single_text``: renders a single input of type text. User's input will
* ``single_text``: renders a single input of type ``time``. User's input will
be validated against the form ``hh:mm`` (or ``hh:mm:ss`` if using seconds).
.. caution::
Combining the widget type ``single_text`` and the `with_minutes`_ option
set to ``false`` can cause unexpected behavior in the client as the input
type ``time`` might not support selecting an hour only.
input
~~~~~
@@ -106,6 +115,8 @@ your underlying object. Valid values are:
The value that comes back from the form will also be normalized back into
this format.
.. include:: /reference/forms/types/options/with_minutes.rst.inc
.. include:: /reference/forms/types/options/with_seconds.rst.inc
.. include:: /reference/forms/types/options/hours.rst.inc

0 comments on commit 8cfb850

Please sign in to comment.