Tipo de campo datetime

Este tipo de campo permite al usuario modificar los datos que representan una fecha y hora específica (por ejemplo, 05/06/2011 12:15:30).

Se pueden reproducir como una entrada de texto o etiquetas de selección. El formato subyacente de los datos puede ser un objeto DateTime, una cadena, una marca de tiempo o un arreglo.

Underlying Data Type can be DateTime, string, timestamp, or array (see the input option)
Rendered as single text box or three select fields
Options
Inherited options
Parent type form
Class Symfony\Component\Form\Extension\Core\Type\DateTimeType

Opciones del campo

date_widget

tipo: string predefinido: choice

Define la opción widget para el tipo date

time_widget

tipo: string predefinido: choice

Define la opción widget para el tipo time

input

tipo: string predefinido: datetime

El formato del dato input —es decir, el formato de la fecha en que se almacena en el objeto subyacente. Los valores válidos son los siguientes:

  • string (por ejemplo 2011-06-05 12:15:00)
  • datetime (un objeto DateTime)
  • array (por ejemplo array(2011, 06, 05, 12, 15, 0))
  • timestamp (por ejemplo 1307276100)

El valor devuelto por el formulario también se normaliza de nuevo a este formato.

date_format

tipo: integer o string predefinido: IntlDateFormatter::MEDIUM

Define la opción format que se transmite al campo de fecha. Consulta la opción de formato para el tipo date para más detalles.

hours

tipo: integer predeterminado: 0 a 23

Lista de las horas disponibles para el tipo de campo hours. Esta opción sólo es relevante cuando la opción widget está establecida en choice.

minutes

tipo: integer predeterminado: 0 a 59

Lista de los minutos disponibles para el tipo de campo minutes. Esta opción sólo es relevante cuando la opción widget está establecida en choice.

seconds

tipo: integer predeterminado: 0 a 59

Lista de los segundos disponibles para el tipo de campo segundos. Esta opción sólo es relevante cuando la opción widget está establecida en choice.

years

tipo: array predeterminado: cinco años antes a cinco años después del año en curso

Lista de años disponibles para el tipo de campo year. Esta opción sólo es relevante cuando la opción widget está establecida en choice.

months

tipo: array predeterminado: 1 a 12

Lista de los meses disponibles para el tipo de campo month. Esta opción sólo es relevante cuando la opción widget está establecida en choice.

days

tipo: array predeterminado: 1 a 31

Lista de los días disponibles para el tipo de campo day. Esta opción sólo es relevante cuando la opción widget está establecida en choice:

'days' => range(1,31)

with_seconds

tipo: Boolean predeterminado: false

Si debe o no incluir los segundos en la entrada. Esto resultará en una entrada adicional para capturar los segundos.

data_timezone

tipo: string predefinido: la zona horaria del sistema

La zona horaria en que se almacenan los datos entrantes. Esta debe ser una de las zonas horarias compatibles con PHP

user_timezone

tipo: string predefinido: la zona horaria del sistema

La zona horaria para mostrar los datos al usuario (y por lo tanto también los datos que el usuario envía). Esta debe ser una de las zonas horarias compatibles con PHP

Opciones heredadas

Estas opciones las hereda del tipo field:

invalid_message

tipo: string predefinido: This value is not valid (Este valor no es válido)

Este es el mensaje para el error de validación utilizado cuando se determina que los datos ingresados en este campo no tienen sentido (es decir, falla la validación).

Esto puede ocurrir, por ejemplo, si el usuario introduce una cadena sin sentido en el campo time que no se puede convertir a una hora real o si el usuario introduce una cadena (por ejemplo, manzana) en un campo de número.

La validación (con la lógica del negocio) normal (por ejemplo, al establecer una longitud mínima en un campo) la debes establecer usando mensajes de validación con tus reglas de validación (referencia).

invalid_message_parameters

tipo: array predeterminado: array()

Al establecer la opción invalid_message, posiblemente sea necesario que incluyas algunas variables en la cadena. Esto se puede lograr agregando marcadores de posición y variables en esa opción:

$builder->add('some_field', 'some_type', array(
    // ...
    'invalid_message'            => 'You entered an invalid value - it should include %num% letters',
    'invalid_message_parameters' => array('%num%' => 6),
));

read_only

Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly HTML attribute. Previously, it rendered as a disabled attribute. Use the disabled option if you need the old behavior.

tipo: Boolean predeterminado: false

If this option is true, the field will be rendered with the readonly attribute so that the field is not editable.

disabled

Nuevo en la versión 2.1: The disabled option is new in version 2.1

type: boolean default: false

Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

These options inherit from the date type:

virtual

tipo: boolean default: false

This option determines if the form will be mapped with data. This can be useful if you need a form to structure the view. See Cómo usar la opción virtual en los campos de formulario.

Bifúrcame en GitHub