{html_select_date} is a custom function that creates date dropdowns. It can display any or all of year, month, and day. All parameters that are not in the list below are printed as name/value-pairs inside the <select> tags of day, month and year.
Attribute Name | Type | Required | Default | Description |
---|---|---|---|---|
prefix | string | No | Date_ | What to prefix the var name with |
time | timestamp/ YYYY-MM-DD | No | current time in unix timestamp or YYYY-MM-DD format | What date/time to use |
start_year | string | No | current year | The first year in the dropdown, either year number, or relative to current year (+/- N) |
end_year | string | No | same as start_year | The last year in the dropdown, either year number, or relative to current year (+/- N) |
display_days | boolean | No | TRUE | Whether to display days or not |
display_months | boolean | No | TRUE | Whether to display months or not |
display_years | boolean | No | TRUE | Whether to display years or not |
month_format | string | No | %B | What format the month should be in (strftime) |
day_format | string | No | %02d | What format the day output should be in (sprintf) |
day_value_format | string | No | %d | What format the day value should be in (sprintf) |
year_as_text | boolean | No | FALSE | Whether or not to display the year as text |
reverse_years | boolean | No | FALSE | Display years in reverse order |
field_array | string | No | null | If a name is given, the select boxes will be drawn such that the results will be returned to PHP in the form of name[Day], name[Year], name[Month]. |
day_size | string | No | null | Adds size attribute to select tag if given |
month_size | string | No | null | Adds size attribute to select tag if given |
year_size | string | No | null | Adds size attribute to select tag if given |
all_extra | string | No | null | Adds extra attributes to all select/input tags if given |
day_extra | string | No | null | Adds extra attributes to select/input tags if given |
month_extra | string | No | null | Adds extra attributes to select/input tags if given |
year_extra | string | No | null | Adds extra attributes to select/input tags if given |
field_order | string | No | MDY | The order in which to display the fields |
field_separator | string | No | \n | String printed between different fields |
month_value_format | string | No | %m | strftime() format of the month values, default is %m for month numbers. |
year_empty | string | No | null | If supplied then the first element of the year's select-box has this value as it's label and "" as it's value. This is useful to make the select-box read "Please select a year" for example. Note that you can use values like "-MM-DD" as time-attribute to indicate an unselected year. |
month_empty | string | No | null | If supplied then the first element of the month's select-box has this value as it's label and "" as it's value. . Note that you can use values like "YYYY--DD" as time-attribute to indicate an unselected month. |
day_empty | string | No | null | If supplied then the first element of the day's select-box has this value as it's label and "" as it's value. Note that you can use values like "YYYY-MM-" as time-attribute to indicate an unselected day. |
Note: There is an useful php function on the date tips page for converting {html_select_date} form values to a timestamp.
Example 8-20. {html_select_date} second example
With 2000 as the current year the output:
|
See also {html_select_time}, date_format, $smarty.now and the date tips page.