Elements

Date

Laminas\Form\Element\Date is meant to be paired with the FormDate helper for HTML5 inputs with type "date". This element adds filters and validators to its input filter specification in order to validate HTML5 date input values on the server.

Basic Usage

This element automatically adds a type attribute of value date.

use Laminas\Form\Element;
use Laminas\Form\Form;

$date = new Element\Date('appointment-date');
$date->setLabel('Appointment Date');
$date->setAttributes([
    'min'  => '2012-01-01',
    'max'  => '2020-01-01',
    'step' => '1', // days; default step interval is 1 day
]);
$date->setOptions([
    'format' => 'Y-m-d',
]);

$form = new Form('my-form');
$form->add($date);

The following uses array notation:

use Laminas\Form\Element;
use Laminas\Form\Form;

$form = new Form('my-form');
$form->add([
    'type' => Element\Date::class,
    'name' => 'appointment-date',
    'options' => [
        'label' => 'Appointment Date',
        'format' => 'Y-m-d',
    ],
    'attributes' => [
        'min' => '2012-01-01',
        'max' => '2020-01-01',
        'step' => '1', // days; default step interval is 1 day
    ],
]);

Set all attributes before calling prepare

The min, max, and step attributes should be set prior to calling Laminas\Form::prepare(). Otherwise, the default input specification for the element may not contain the correct validation rules.

Public Methods

The following methods are specific to the Date element; all other methods inherited from the parent DateTime class are also available.