{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}日期技巧.