{html_select_date}
Prev Chapter 8. 自定义函数 Next

{html_select_date}

{html_select_date}是一个 自定义函数，用于创建一个选择日期的下拉框。 它可以显示任何或者全部的年、月、日。 任何不在上面列表中的键值对属性，都会被输出到<select>标签中作为属性和值。

参数名称 类型 必选参数 默认值 说明
prefix string No Date_ 下拉框名称的前缀
time 时间戳, DateTime, mysql时间戳或任何strtotime() 能支持的字符串，或者是数组（当设置了field_array） No 当前 时间戳 默认选中的日期。如果提供了数组，那么field_array和prefix属性将单独作用在每个数组元素上， 包括年月日。
start_year string No 当前年份 下拉框开始显示的年份，可以设置一个年份数字或者默认当前年份(+/- N)
end_year string No same as start_year 下拉框结束显示的年份，可以设置一个年份的数字或者默认当前年份(+/- N)
display_days boolean No TRUE 是否显示日期
display_months boolean No TRUE 是否显示月份
display_years boolean No TRUE 是否显示年份
month_format array No null 月份显示的字符串的数组.如 array(1 => 'Jan', …, 12 => 'Dec')
month_names string No %B 月份显示的格式 (strftime)
day_format string No %02d 日期显示的格式 (sprintf)
day_value_format string No %d 日期值显示的格式 (sprintf)
year_as_text boolean No FALSE 是否将年份显示为文字
reverse_years boolean No FALSE 是否按倒序显示年份
field_array string No null 如果设置了field_array值，则下拉框的值发送的PHP时，将会是 值[Day], 值[Year], 值[Month]的格式。
day_size string No null 附加日期select标签的size属性
month_size string No null 附加月份select标签的size属性
year_size string No null 附加年份select标签的size属性
all_extra string No null 附加给全部select/input标签附加的属性
day_extra string No null 附加给日期select/input标签附加的属性
month_extra string No null 附加给月份select/input标签附加的属性
year_extra string No null 附加给年份select/input标签附加的属性
all_id string No null 全部select/input标签的ID值
day_id string No null 日期select/input标签的ID值
month_id string No null 月份select/input标签的ID值
year_id string No null 年份select/input标签的ID值
field_order string No MDY 显示各下拉框的顺序
field_separator string No \n 显示在各字段之间间隔的字符串
month_value_format string No %m 月份值的显示格式（按strftime()）默认是 %m
all_empty string No null 该属性可以在每个下拉框的第一行显示文字，并以“”作为它的值。 在需要让下拉框的第一行显示“请选择” 的情况下比较有用。
year_empty string No null 该属性可以在年份下拉框的第一行显示文字，并以“”作为它的值。 在需要让年份下拉框的第一行显示“请选择年份” 的情况下比较有用。 注意你可以使用如“-MM-DD”的值，作为时间属性来显示没有选中的年份。
month_empty string No null 该属性可以在月份下拉框的第一行显示文字，并以“”作为它的值。 注意你可以使用如“YYYY--DD”的值，作为时间属性来显示没有选中的月份。
day_empty string No null 该属性可以在日期下拉框的第一行显示文字，并以“”作为它的值。 注意你可以使用如“YYYY-MM-”的值，作为时间属性来显示没有选中的日期。

Note

在日期技巧文章中，介绍了 较有用的php函数来将{html_select_date}值转换成时间戳。

Example 8.16. {html_select_date}

模板代码


{html_select_date}

输出 


<select name="Date_Month">
<option value="1">January</option>
<option value="2">February</option>
<option value="3">March</option>
  ..... snipped .....
<option value="10">October</option>
<option value="11">November</option>
<option value="12" selected="selected">December</option>
</select>
<select name="Date_Day">
<option value="1">01</option>
<option value="2">02</option>
<option value="3">03</option>
  ..... snipped .....
<option value="11">11</option>
<option value="12">12</option>
<option value="13" selected="selected">13</option>
<option value="14">14</option>
<option value="15">15</option>
  ..... snipped .....
<option value="29">29</option>
<option value="30">30</option>
<option value="31">31</option>
</select>
<select name="Date_Year">
<option value="2006" selected="selected">2006</option>
</select>

Example 8.17. {html_select_date} 第二个地理


{* start and end year can be relative to current year *}
{html_select_date prefix='StartDate' time=$time start_year='-5'
   end_year='+1' display_days=false}

如果当前是 2000年 则输出: 


<select name="StartDateMonth">
<option value="1">January</option>
<option value="2">February</option>
.... snipped ....
<option value="11">November</option>
<option value="12" selected="selected">December</option>
</select>
<select name="StartDateYear">
<option value="1995">1995</option>
.... snipped ....
<option value="1999">1999</option>
<option value="2000" selected="selected">2000</option>
<option value="2001">2001</option>
</select>

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

Prev Up Next
{html_radios} Home {html_select_time}