{html_select_time}
is a
custom function
that creates time dropdowns for you.
It can display any or all of hour, minute, second and meridian.
The time
attribute can have different formats.
It can be a unique timestamp, a string of the format
YYYYMMDDHHMMSS
or a string that is parseable by PHP's
strtotime()
.
Attribute Name | Type | Required | Default | Description |
---|---|---|---|---|
prefix | string | No | Time_ | What to prefix the var name with |
time |
timestamp,
DateTime,
mysql timestamp or any string parsable by
strtotime() ,
arrays as produced by this function if field_array is set.
|
No | current timestamp | What date/time to pre-select. If an array is given, the attributes field_array and prefix are used to identify the array elements to extract hour, minute, second and meridian from. |
display_hours | boolean | No | TRUE |
Whether or not to display hours |
display_minutes | boolean | No | TRUE |
Whether or not to display minutes |
display_seconds | boolean | No | TRUE |
Whether or not to display seconds |
display_meridian | boolean | No | TRUE |
Whether or not to display meridian (am/pm) |
use_24_hours | boolean | No | TRUE |
Whether or not to use 24 hour clock |
minute_interval | integer | No | 1 | Number interval in minute dropdown |
second_interval | integer | No | 1 | Number interval in second dropdown |
hour_format | string | No | %02d | What format the hour label should be in (sprintf) |
hour_value_format | string | No | %20d | What format the hour value should be in (sprintf) |
minute_format | string | No | %02d | What format the minute label should be in (sprintf) |
minute_value_format | string | No | %20d | What format the minute value should be in (sprintf) |
second_format | string | No | %02d | What format the second label should be in (sprintf) |
second_value_format | string | No | %20d | What format the second value should be in (sprintf) |
field_array | string | No | n/a | Outputs values to array of this name |
all_extra | string | No | null | Adds extra attributes to select/input tags if given |
hour_extra | string | No | null | Adds extra attributes to select/input tags if given |
minute_extra | string | No | null | Adds extra attributes to select/input tags if given |
second_extra | string | No | null | Adds extra attributes to select/input tags if given |
meridian_extra | string | No | null | Adds extra attributes to select/input tags if given |
field_separator | string | No | \n | String printed between different fields |
option_separator | string | No | \n | String printed between different options of a field |
all_id | string | No | null | Adds id-attribute to all select/input tags if given |
hour_id | string | No | null | Adds id-attribute to select/input tags if given |
minute_id | string | No | null | Adds id-attribute to select/input tags if given |
second_id | string | No | null | Adds id-attribute to select/input tags if given |
meridian_id | string | No | null | Adds id-attribute to select/input tags if given |
all_empty | string | No | null | If supplied then the first element of any select-box has this value as it's label and “” as it's value. This is useful to make the select-boxes read “Please select” for example. |
hour_empty | string | No | null | If supplied then the first element of the hour'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 an hour” for example. |
minute_empty | string | No | null | If supplied then the first element of the minute'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 an minute” for example. |
second_empty | string | No | null | If supplied then the first element of the second'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 an second” for example. |
meridian_empty | string | No | null | If supplied then the first element of the meridian'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 an meridian” for example. |
Пример 8.18. {html_select_time}
{html_select_time use_24_hours=true}
At 9:20 and 23 seconds in the morning the template above would output:
<select name="Time_Hour"> <option value="00">00</option> <option value="01">01</option> ... snipped .... <option value="08">08</option> <option value="09" selected>09</option> <option value="10">10</option> ... snipped .... <option value="22">22</option> <option value="23">23</option> </select> <select name="Time_Minute"> <option value="00">00</option> <option value="01">01</option> ... snipped .... <option value="19">19</option> <option value="20" selected>20</option> <option value="21">21</option> ... snipped .... <option value="58">58</option> <option value="59">59</option> </select> <select name="Time_Second"> <option value="00">00</option> <option value="01">01</option> ... snipped .... <option value="22">22</option> <option value="23" selected>23</option> <option value="24">24</option> ... snipped .... <option value="58">58</option> <option value="59">59</option> </select> <select name="Time_Meridian"> <option value="am" selected>AM</option> <option value="pm">PM</option> </select>
See also
$smarty.now
,
{html_select_date}
and the date tips page.