DateTimeType

class DateTimeType extends AbstractType

Constants

DEFAULT_DATE_FORMAT
DEFAULT_TIME_FORMAT
HTML5_FORMAT

This is not quite the HTML5 format yet, because ICU lacks the capability of parsing and generating RFC 3339 dates, which are like the below pattern but with a timezone suffix. The timezone suffix is.

  • "Z" for UTC
    • "(-|+)HH:mm" for other timezones (note the colon!)

For more information see:

http://userguide.icu-project.org/formatparse/datetime#TOC-Date-Time-Format-Syntax http://www.w3.org/TR/html-markup/input.datetime.html http://tools.ietf.org/html/rfc3339

An ICU ticket was created: http://icu-project.org/trac/ticket/9421

It was supposedly fixed, but is not available in all PHP installations yet. To temporarily circumvent this issue, DateTimeToRfc3339Transformer is used when the format matches this constant.

Methods

buildForm(FormBuilderInterface $builder, array $options)

Builds the form.

buildView(FormView $view, FormInterface $form, array $options)

Builds the form view.

finishView(FormView $view, FormInterface $form, array $options)

Finishes the form view.

from AbstractType
setDefaultOptions(OptionsResolverInterface $resolver)

Sets the default options for this type.

from AbstractType
configureOptions(OptionsResolver $resolver)

Configures the options for this type.

string|null|FormTypeInterface getParent()

Returns the name of the parent type.

from AbstractType
string getName()

Returns the name of this type.

Details

buildForm(FormBuilderInterface $builder, array $options)

Builds the form.

This method is called for each type in the hierarchy starting from the top most type. Type extensions can further modify the form.

Parameters

FormBuilderInterface $builder The form builder
array $options The options

buildView(FormView $view, FormInterface $form, array $options)

Builds the form view.

This method is called for each type in the hierarchy starting from the top most type. Type extensions can further modify the view.

A view of a form is built before the views of the child forms are built. This means that you cannot access child views in this method. If you need to do so, move your logic to {@link finishView()} instead.

Parameters

FormView $view The view
FormInterface $form The form
array $options The options

finishView(FormView $view, FormInterface $form, array $options)

Finishes the form view.

This method gets called for each type in the hierarchy starting from the top most type. Type extensions can further modify the view.

When this method is called, views of the form's children have already been built and finished and can be accessed. You should only implement such logic in this method that actually accesses child views. For everything else you are recommended to implement {@link buildView()} instead.

Parameters

FormView $view The view
FormInterface $form The form
array $options The options

setDefaultOptions(OptionsResolverInterface $resolver)

Sets the default options for this type.

Parameters

OptionsResolverInterface $resolver The resolver for the options

configureOptions(OptionsResolver $resolver)

Configures the options for this type.

Parameters

OptionsResolver $resolver The resolver for the options

string|null|FormTypeInterface getParent()

Returns the name of the parent type.

You can also return a type instance from this method, although doing so is discouraged because it leads to a performance penalty. The support for returning type instances may be dropped from future releases.

Return Value

string|null|FormTypeInterface The name of the parent type if any, null otherwise

string getName()

Returns the name of this type.

Return Value

string The name of this type

© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/2.7/Symfony/Component/Form/Extension/Core/Type/DateTimeType.html