[Form] Add input_format option to DateType and DateTimeType

Co-Authored-By: Andrii Dembitskyi <[email protected]>

Author: fancyweb

reference/forms/types/birthday.rst

@@ -29,6 +29,7 @@ option defaults to 120 years ago to the current year.
 |                      | - `placeholder`_                                                              |
 |                      | - `format`_                                                                   |
 |                      | - `input`_                                                                    |
+|                      | - `input_format`_                                                             |
 |                      | - `model_timezone`_                                                           |
 |                      | - `months`_                                                                   |
 |                      | - `view_timezone`_                                                            |
@@ -96,6 +97,8 @@ values for the year, month and day fields::
 
 .. include:: /reference/forms/types/options/date_input.rst.inc
 
+.. include:: /reference/forms/types/options/date_input_format.rst.inc
+
 .. include:: /reference/forms/types/options/model_timezone.rst.inc
 
 .. include:: /reference/forms/types/options/months.rst.inc

reference/forms/types/date.rst

@@ -21,6 +21,7 @@ and can understand a number of different input formats via the `input`_ option.
 |                      | - `format`_                                                                 |
 |                      | - `html5`_                                                                  |
 |                      | - `input`_                                                                  |
+|                      | - `input_format`_                                                           |
 |                      | - `model_timezone`_                                                         |
 |                      | - `months`_                                                                 |
 |                      | - `view_timezone`_                                                          |
@@ -168,6 +169,8 @@ values for the year, month and day fields::
 
 .. include:: /reference/forms/types/options/date_input.rst.inc
 
+.. include:: /reference/forms/types/options/date_input_format.rst.inc
+
 .. include:: /reference/forms/types/options/model_timezone.rst.inc
 
 .. include:: /reference/forms/types/options/months.rst.inc

reference/forms/types/datetime.rst

@@ -25,6 +25,7 @@ the data can be a ``DateTime`` object, a string, a timestamp or an array.
 |                      | - `hours`_                                                                  |
 |                      | - `html5`_                                                                  |
 |                      | - `input`_                                                                  |
+|                      | - `input_format`_                                                           |
 |                      | - `minutes`_                                                                |
 |                      | - `model_timezone`_                                                         |
 |                      | - `months`_                                                                 |
@@ -153,6 +154,13 @@ this format.
 
 .. include:: /reference/forms/types/options/_date_limitation.rst.inc
 
+input_format
+~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``Y-m-d H:i:s``
+
+.. include:: /reference/forms/types/options/date_input_format_description.rst.inc
+
 .. include:: /reference/forms/types/options/minutes.rst.inc
 
 .. include:: /reference/forms/types/options/model_timezone.rst.inc

reference/forms/types/options/date_input_format.rst.inc

@@ -0,0 +1,6 @@
+input_format
+~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``Y-m-d``
+
+.. include:: /reference/forms/types/options/date_input_format_description.rst.inc

reference/forms/types/options/date_input_format_description.rst.inc

@@ -0,0 +1,4 @@
+If the ``input`` option is set to ``string``, this option specifies the format
+of the date. This must be a valid `PHP date format`_.
+
+.. _`PHP date format`: https://secure.php.net/manual/en/function.date.php