Просмотр файла manual-ru/language.function.html.select.date.html

Конкурс дизайнеров на 15000 рублей
Милый пушистый сайт !!!!
Размер файла: 13.78Kb 
  1. <html>
  2. <head>
  3. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  4. <title>{html_select_date}</title>
  5. <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
  6. <link rel="home" href="index.html" title="Руководство по Smarty">
  7. <link rel="up" href="language.custom.functions.html" title="Chapter 8. Пользовательские Функции">
  8. <link rel="prev" href="language.function.html.radios.html" title="{html_radios}">
  9. <link rel="next" href="language.function.html.select.time.html" title="{html_select_time}">
  10. </head>
  11. <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  12. <div class="navheader">
  13. <table width="100%" summary="Navigation header">
  14. <tr><th colspan="3" align="center">{html_select_date}</th></tr>
  15. <tr>
  16. <td width="20%" align="left">
  17. <a accesskey="p" href="language.function.html.radios.html">Prev</a> </td>
  18. <th width="60%" align="center">Chapter 8. Пользовательские Функции</th>
  19. <td width="20%" align="right"> <a accesskey="n" href="language.function.html.select.time.html">Next</a>
  20. </td>
  21. </tr>
  22. </table>
  23. <hr>
  24. </div>
  25. <div class="sect1" title="{html_select_date}">
  26. <div class="titlepage"><div><div><h2 class="title" style="clear: both">
  27. <a name="language.function.html.select.date"></a>{html_select_date}</h2></div></div></div>
  28. <p>
  29.   {html_select_date} является
  30.   <a class="link" href="language.custom.functions.html" title="Chapter 8. Пользовательские Функции">пользовательской функцией</a>,
  31.   которая создает выпадающее меню для выбора даты.
  32.   Она может отображать поля для года, месяца и дня.
  33.  </p>
  34. <div class="informaltable"><table border="1">
  35. <colgroup>
  36. <col align="center">
  37. <col align="center">
  38. <col align="center">
  39. <col align="center">
  40. <col>
  41. </colgroup>
  42. <thead><tr>
  43. <th align="center">Имя атрибута</th>
  44. <th align="center">Тип</th>
  45. <th align="center">Обязателен</th>
  46. <th align="center">По умолчанию</th>
  47. <th>Описание</th>
  48. </tr></thead>
  49. <tbody>
  50. <tr>
  51. <td align="center">prefix</td>
  52. <td align="center">string</td>
  53. <td align="center">Нет</td>
  54. <td align="center">Date_</td>
  55. <td>префикс названий переменных</td>
  56. </tr>
  57. <tr>
  58. <td align="center">time</td>
  59. <td align="center">timestamp/ГГГГ-ММ-ДД</td>
  60. <td align="center">Нет</td>
  61. <td align="center">
  62.      текущее время в формате unix timestamp или ГГГГ-ММ-ДД
  63.     </td>
  64. <td>используемое время</td>
  65. </tr>
  66. <tr>
  67. <td align="center">start_year</td>
  68. <td align="center">string</td>
  69. <td align="center">Нет</td>
  70. <td align="center">текущий год</td>
  71. <td>
  72.      Начальный год в выпадающем списке. Либо указывается явно, либо
  73.      относительно текущего года (+/- N)
  74.     </td>
  75. </tr>
  76. <tr>
  77. <td align="center">end_year</td>
  78. <td align="center">string</td>
  79. <td align="center">Нет</td>
  80. <td align="center">аналогично start_year</td>
  81. <td>
  82.      Конечный год в выпадающем списке. Либо указывается явно, либо
  83.      относительно текущего года (+/- N)
  84.     </td>
  85. </tr>
  86. <tr>
  87. <td align="center">display_days</td>
  88. <td align="center">boolean</td>
  89. <td align="center">Нет</td>
  90. <td align="center">true</td>
  91. <td>выводить ли список дней</td>
  92. </tr>
  93. <tr>
  94. <td align="center">display_months</td>
  95. <td align="center">boolean</td>
  96. <td align="center">Нет</td>
  97. <td align="center">true</td>
  98. <td>выводить ли список месяцев</td>
  99. </tr>
  100. <tr>
  101. <td align="center">display_years</td>
  102. <td align="center">boolean</td>
  103. <td align="center">Нет</td>
  104. <td align="center">true</td>
  105. <td>выводить ли список лет</td>
  106. </tr>
  107. <tr>
  108. <td align="center">month_format</td>
  109. <td align="center">string</td>
  110. <td align="center">Нет</td>
  111. <td align="center">%B</td>
  112. <td>Формат названия месяцев (strftime)</td>
  113. </tr>
  114. <tr>
  115. <td align="center">day_format</td>
  116. <td align="center">string</td>
  117. <td align="center">Нет</td>
  118. <td align="center">%02d</td>
  119. <td>формат названия дней (sprintf)</td>
  120. </tr>
  121. <tr>
  122. <td align="center">day_value_format</td>
  123. <td align="center">string</td>
  124. <td align="center">Нет</td>
  125. <td align="center">%d</td>
  126. <td>формат значения дней (sprintf)</td>
  127. </tr>
  128. <tr>
  129. <td align="center">year_as_text</td>
  130. <td align="center">boolean</td>
  131. <td align="center">Нет</td>
  132. <td align="center">false</td>
  133. <td>Выводить ли значение года текстом</td>
  134. </tr>
  135. <tr>
  136. <td align="center">reverse_years</td>
  137. <td align="center">boolean</td>
  138. <td align="center">Нет</td>
  139. <td align="center">false</td>
  140. <td>Выводить года в обратном порядке</td>
  141. </tr>
  142. <tr>
  143. <td align="center">field_array</td>
  144. <td align="center">string</td>
  145. <td align="center">Нет</td>
  146. <td align="center">null</td>
  147. <td>
  148.      название переменной (name), которая будет
  149.      содержать выбранные значения в виде массива:
  150.      name[Day], name[Year], name[Month].
  151.     </td>
  152. </tr>
  153. <tr>
  154. <td align="center">day_size</td>
  155. <td align="center">string</td>
  156. <td align="center">Нет</td>
  157. <td align="center">null</td>
  158. <td>Устанавливает атрибут size тэга select для дней</td>
  159. </tr>
  160. <tr>
  161. <td align="center">month_size</td>
  162. <td align="center">string</td>
  163. <td align="center">Нет</td>
  164. <td align="center">null</td>
  165. <td>Устанавливает атрибут size тэга select для месяцев</td>
  166. </tr>
  167. <tr>
  168. <td align="center">year_size</td>
  169. <td align="center">string</td>
  170. <td align="center">Нет</td>
  171. <td align="center">null</td>
  172. <td>Устанавливает атрибут size тэга select для лет</td>
  173. </tr>
  174. <tr>
  175. <td align="center">all_extra</td>
  176. <td align="center">string</td>
  177. <td align="center">Нет</td>
  178. <td align="center">null</td>
  179. <td>
  180.      Устанавливает дополнительные атрибуты для всех тэгов
  181.      select/input
  182.     </td>
  183. </tr>
  184. <tr>
  185. <td align="center">day_extra</td>
  186. <td align="center">string</td>
  187. <td align="center">Нет</td>
  188. <td align="center">null</td>
  189. <td>
  190.      Устанавливает дополнительные атрибуты тэгов select/input для
  191.      дней
  192.     </td>
  193. </tr>
  194. <tr>
  195. <td align="center">month_extra</td>
  196. <td align="center">string</td>
  197. <td align="center">Нет</td>
  198. <td align="center">null</td>
  199. <td>
  200.      Устанавливает дополнительные атрибуты тэгов select/input для месяцев
  201.     </td>
  202. </tr>
  203. <tr>
  204. <td align="center">year_extra</td>
  205. <td align="center">string</td>
  206. <td align="center">Нет</td>
  207. <td align="center">null</td>
  208. <td>
  209.      Устанавливает дополнительные атрибуты тэгов select/input для лет
  210.     </td>
  211. </tr>
  212. <tr>
  213. <td align="center">field_order</td>
  214. <td align="center">string</td>
  215. <td align="center">Нет</td>
  216. <td align="center">MDY</td>
  217. <td>Порядок следования полей (МДГ)</td>
  218. </tr>
  219. <tr>
  220. <td align="center">field_separator</td>
  221. <td align="center">string</td>
  222. <td align="center">Нет</td>
  223. <td align="center">\n</td>
  224. <td>текст, разделяющий поля</td>
  225. </tr>
  226. <tr>
  227. <td align="center">month_value_format</td>
  228. <td align="center">string</td>
  229. <td align="center">Нет</td>
  230. <td align="center">%m</td>
  231. <td>
  232.      формат значения месяца (strftime).
  233.      По умолчанию - %m (номер месяца).
  234.     </td>
  235. </tr>
  236. <tr>
  237. <td align="center">year_empty</td>
  238. <td align="center">string</td>
  239. <td align="center">Нет</td>
  240. <td align="center">null</td>
  241. <td>
  242.       Если указан, первый пункт элемента для выбора года станет такой надписью
  243.       с пустым ("") значением.
  244.       Это удобно для создания надписей вроде "Пожалуйста, выберите год" в
  245.       качестве первого пункта выпадающего меню.
  246.       Обратите внимание, что вы можете использовать значения типа "-MM-DD"
  247.       для атрибута time, чтобы не выбирать год заранее.
  248.      </td>
  249. </tr>
  250. <tr>
  251. <td align="center">month_empty</td>
  252. <td align="center">string</td>
  253. <td align="center">No</td>
  254. <td align="center">null</td>
  255. <td>
  256.       Если указан, первый пункт элемента для выбора месяца станет такой надписью
  257.       с пустым ("") значением.
  258.       Обратите внимание, что вы можете использовать значения типа "YYYY--DD"
  259.       для атрибута time, чтобы не выбирать месяц заранее.
  260.      </td>
  261. </tr>
  262. <tr>
  263. <td align="center">day_empty</td>
  264. <td align="center">string</td>
  265. <td align="center">No</td>
  266. <td align="center">null</td>
  267. <td>
  268.       Если указан, первый пункт элемента для выбора дня станет такой надписью
  269.       с пустым ("") значением.
  270.       Обратите внимание, что вы можете использовать значения типа "YYY-MM-"
  271.       для атрибута time, чтобы не выбирать день заранее.
  272.      </td>
  273. </tr>
  274. </tbody>
  275. </table></div>
  276. <p>
  277.   Все параметры, которые не указаны в списке, выводятся в виде
  278.   пар name/value в каждом созданном тэге &lt;select&gt; для дня,
  279.   месяца и года.
  280.  </p>
  281. <div class="example">
  282. <a name="id2691220"></a><p class="title"><b>Example 8.17. {html_select_date}</b></p>
  283. <div class="example-contents">
  284. <p>Шаблон:</p>
  285. <pre class="programlisting">
  286.  
  287. {html_select_date}
  288.  
  289.   </pre>
  290. <p>
  291.    Результат обработки шаблона:
  292.   </p>
  293. <pre class="screen">
  294.  
  295. &lt;select name="Date_Month"&gt;
  296. &lt;option value="1"&gt;January&lt;/option&gt;
  297. &lt;option value="2"&gt;February&lt;/option&gt;
  298. &lt;option value="3"&gt;March&lt;/option&gt;
  299.   ..... snipped .....
  300. &lt;option value="10"&gt;October&lt;/option&gt;
  301. &lt;option value="11"&gt;November&lt;/option&gt;
  302. &lt;option value="12" selected="selected"&gt;December&lt;/option&gt;
  303. &lt;/select&gt;
  304. &lt;select name="Date_Day"&gt;
  305. &lt;option value="1"&gt;01&lt;/option&gt;
  306. &lt;option value="2"&gt;02&lt;/option&gt;
  307. &lt;option value="3"&gt;03&lt;/option&gt;
  308.   ..... snipped .....
  309. &lt;option value="11"&gt;11&lt;/option&gt;
  310. &lt;option value="12"&gt;12&lt;/option&gt;
  311. &lt;option value="13" selected="selected"&gt;13&lt;/option&gt;
  312. &lt;option value="14"&gt;14&lt;/option&gt;
  313. &lt;option value="15"&gt;15&lt;/option&gt;
  314.   ..... snipped .....
  315. &lt;option value="29"&gt;29&lt;/option&gt;
  316. &lt;option value="30"&gt;30&lt;/option&gt;
  317. &lt;option value="31"&gt;31&lt;/option&gt;
  318. &lt;/select&gt;
  319. &lt;select name="Date_Year"&gt;
  320. &lt;option value="2001" selected="selected"&gt;2001&lt;/option&gt;
  321. &lt;/select&gt;
  322.  
  323.   </pre>
  324. </div>
  325. </div>
  326. <br class="example-break"><div class="example">
  327. <a name="id2691248"></a><p class="title"><b>Example 8.18. {html_select_date}</b></p>
  328. <div class="example-contents">
  329. <pre class="programlisting">
  330.  
  331. {* года начала и конца могут быть заданы относительно текущего года *}
  332. {html_select_date prefix="StartDate" time=$time start_year="-5"
  333.    end_year="+1" display_days=false}
  334.  
  335.   </pre>
  336. <p>
  337.    Результатом обработки шаблона будет: (текущий год - 2000)
  338.   </p>
  339. <pre class="screen">
  340.  
  341. &lt;select name="StartDateMonth"&gt;
  342. &lt;option value="1"&gt;January&lt;/option&gt;
  343. &lt;option value="2"&gt;February&lt;/option&gt;
  344. &lt;option value="3"&gt;March&lt;/option&gt;
  345. &lt;option value="4"&gt;April&lt;/option&gt;
  346. &lt;option value="5"&gt;May&lt;/option&gt;
  347. &lt;option value="6"&gt;June&lt;/option&gt;
  348. &lt;option value="7"&gt;July&lt;/option&gt;
  349. &lt;option value="8"&gt;August&lt;/option&gt;
  350. &lt;option value="9"&gt;September&lt;/option&gt;
  351. &lt;option value="10"&gt;October&lt;/option&gt;
  352. &lt;option value="11"&gt;November&lt;/option&gt;
  353. &lt;option value="12" selected="selected"&gt;December&lt;/option&gt;
  354. &lt;/select&gt;
  355. &lt;select name="StartDateYear"&gt;
  356. &lt;option value="1995"&gt;1995&lt;/option&gt;
  357. &lt;option value="1996"&gt;1996&lt;/option&gt;
  358. &lt;option value="1997"&gt;1997&lt;/option&gt;
  359. &lt;option value="1998"&gt;1998&lt;/option&gt;
  360. &lt;option value="1999"&gt;1999&lt;/option&gt;
  361. &lt;option value="2000" selected="selected"&gt;2000&lt;/option&gt;
  362. &lt;option value="2001"&gt;2001&lt;/option&gt;
  363. &lt;/select&gt;
  364.  
  365.   </pre>
  366. </div>
  367. </div>
  368. <br class="example-break"><p>
  369.   См. также
  370.   <a class="link" href="language.function.html.select.time.html" title="{html_select_time}">{html_select_time}</a>,
  371.   <a class="link" href="language.modifier.date.format.html" title="date_format">date_format</a>,
  372.   <a class="link" href="language.variables.smarty.html#language.variables.smarty.now" title="{$smarty.now}">$smarty.now</a>
  373.   и
  374.   <a class="link" href="tips.dates.html" title="Даты">Советы относительно дат</a>.
  375.  </p>
  376. </div>
  377. <div class="navfooter">
  378. <hr>
  379. <table width="100%" summary="Navigation footer">
  380. <tr>
  381. <td width="40%" align="left">
  382. <a accesskey="p" href="language.function.html.radios.html">Prev</a> </td>
  383. <td width="20%" align="center"><a accesskey="u" href="language.custom.functions.html">Up</a></td>
  384. <td width="40%" align="right"> <a accesskey="n" href="language.function.html.select.time.html">Next</a>
  385. </td>
  386. </tr>
  387. <tr>
  388. <td width="40%" align="left" valign="top">{html_radios} </td>
  389. <td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
  390. <td width="40%" align="right" valign="top"> {html_select_time}</td>
  391. </tr>
  392. </table>
  393. </div>
  394. </body>
  395. </html>