Smarty: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}
和 日期技巧.