8. 自定义函数 - {html_select_time} - 《Smarty3 手册》

{html_select_time}

{html_select_time}

{html_select_time}是一个自定义函数，用于创建一个选择时间的下拉框。它可以显示任何或全部的小时、分钟、秒和上下午。

time属性可以是多种格式。它可以是时间戳，一个格式为 YYYYMMDDHHMMSS的字符串，或者是PHP函数 strtotime() 能支持的字符串。

参数名称	类型	必选参数	默认值	说明
prefix	string	No	Time_	下拉框名称的前缀
time	时间戳, DateTime, mysql时间戳或任何`strtotime()` 能支持的字符串，或者是数组（当设置了field_array）	No	当前时间戳	默认选中的时间。如果提供了数组，那么field_array和prefix属性将单独作用在每个数组元素上，包括小时、分钟、秒数和上下午。
display_hours	boolean	No	`TRUE`	是否显示小时数
display_minutes	boolean	No	`TRUE`	是否显示分钟数
display_seconds	boolean	No	`TRUE`	是否显示秒数
display_meridian	boolean	No	`TRUE`	是否显示上下午 (am/pm)
use_24_hours	boolean	No	`TRUE`	是否使用24小时格式的时间
minute_interval	integer	No	1	分钟下拉框的时间间隔
second_interval	integer	No	1	秒数下拉框的时间间隔
hour_format	string	No	%02d	小时的格式(sprintf)
hour_value_format	string	No	%20d	小时值的格式(sprintf)
minute_format	string	No	%02d	分钟的格式(sprintf)
minute_value_format	string	No	%20d	分钟值的格式(sprintf)
second_format	string	No	%02d	秒数的格式(sprintf)
second_value_format	string	No	%20d	秒数值的格式(sprintf)
field_array	string	No	n/a	显示值数组的名称
all_extra	string	No	null	附加给select/input标签附加的属性
hour_extra	string	No	null	附加给小时下拉框select/input标签的属性
minute_extra	string	No	null	附加给分钟下拉框select/input标签的属性
second_extra	string	No	null	附加给秒数下拉框select/input标签的属性
meridian_extra	string	No	null	附加给上下午下拉框select/input标签的属性
field_separator	string	No	\n	显示在各字段之间间隔的字符串
option_separator	string	No	\n	显示在各选项之间的字符串
all_id	string	No	null	全部select/input标签的ID值
hour_id	string	No	null	小时下拉框select/input标签的ID值
minute_id	string	No	null	分钟下拉框select/input标签的ID值
second_id	string	No	null	秒数下拉框select/input标签的ID值
meridian_id	string	No	null	上下午下拉框select/input标签的ID值
all_empty	string	No	null	该属性可以在每个下拉框的第一行显示文字，并以“”作为它的值。在需要让下拉框的第一行显示“请选择” 的情况下比较有用。
hour_empty	string	No	null	该属性可以在小时下拉框的第一行显示文字，并以“”作为它的值。在需要让小时下拉框的第一行显示“请选择小时” 的情况下比较有用。
minute_empty	string	No	null	该属性可以在分钟下拉框的第一行显示文字，并以“”作为它的值。在需要让分钟下拉框的第一行显示“请选择分钟” 的情况下比较有用。
second_empty	string	No	null	该属性可以在秒数下拉框的第一行显示文字，并以“”作为它的值。在需要让秒数下拉框的第一行显示“请选择秒数” 的情况下比较有用。
meridian_empty	string	No	null	该属性可以在上下午下拉框的第一行显示文字，并以“”作为它的值。在需要让上下午下拉框的第一行显示“请选择上午或下午” 的情况下比较有用。

Example 8.18. {html_select_time}

{html_select_time use_24_hours=true}

当早上9点20分23秒的时候，模板将显示：

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

参见 $smarty.now, {html_select_date} 和日期技巧.

原文: https://www.smarty.net/docs/zh_CN/language.function.html.select.time.tpl