{html_select_time}

{html_select_time}
Prev	Chapter 8. Custom Functions	Next

{html_select_time}

{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.

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>

Prev	Up	Next
{html_select_date}	Home	{html_table}

Comments

No comments for this page.

Get Smarty

About Smarty

Resources

Links

Donate

Smarty Icon

Sites Using Smarty

Advertisement

{html_select_time}

Advertisement

Sponsors [info]

Sponsors