The $options parameter controls the element's appearance. It is an associative array of the form 'option name' => 'option value'.
Recognised option names
Language code to use for display. Default is 'en'.
date element supports many languages. If your one is not supported, send us the translation, we'll gladly include it.
Format string for the date, based on PHP's date() function. The following characters are recognised:
D => Short names of days l => Long names of days d => Day numbers M => Short names of months F => Long names of months m => Month numbers Y => Four digit year y => Two digit year h => 12 hour format H => 23 hour format i => Minutes s => Seconds a => am/pm A => AM/PM g => 12 hour format w/o leading zeroes W => week of the year
Minimum year in year select. Default is 2001.
Maximum year in year select. Default is 2010.
On 'minYear' and 'maxYear': When 'minYear' > 'maxYear' the years in the select will be displayed in descending order.
Should an empty option be added to the top of each select box? Default is FALSE. This may be set for individual fields also, if one passes an array of the form array('format char' => TRUE, ..., 'another format char' => FALSE)
The value passed by the empty option. Default is ''.
The text displayed for the empty option. Default is ' '. This may be set for individual fields also, if one passes an array of the form array('format char' => 'some text', ..., 'another format char' => 'some other text')
Step to increase the option values by. Works for 'i' and 's' formats currently. Default is array('i' => 1, 's' => 1).
Label(s) for an element
Options to control the element's display
Either a typical HTML attribute string or an associative array