What is Smarty?
Why use it?
Use Cases and Work Flow
Syntax Comparison
Template Inheritance
Best Practices
Crash Course
You may use the Smarty logo according to the trademark notice.
For sponsorship, advertising, news or other inquiries, contact us at:
{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}
和 日期技巧.