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

Конкурс дизайнеров на 15000 рублей
AdsLink интернет реклама
Размер файла: 12.31Kb 
  1. <html>
  2. <head>
  3. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  4. <title>date_format</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.modifiers.html" title="Chapter 5. Модификаторы переменных">
  8. <link rel="prev" href="language.modifier.count.words.html" title="count_words">
  9. <link rel="next" href="language.modifier.default.html" title="default">
  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">date_format</th></tr>
  15. <tr>
  16. <td width="20%" align="left">
  17. <a accesskey="p" href="language.modifier.count.words.html">Prev</a> </td>
  18. <th width="60%" align="center">Chapter 5. Модификаторы переменных</th>
  19. <td width="20%" align="right"> <a accesskey="n" href="language.modifier.default.html">Next</a>
  20. </td>
  21. </tr>
  22. </table>
  23. <hr>
  24. </div>
  25. <div class="sect1" title="date_format">
  26. <div class="titlepage"><div><div><h2 class="title" style="clear: both">
  27. <a name="language.modifier.date.format"></a>date_format</h2></div></div></div>
  28. <p>
  29.      Форматирует дату согласно указанному формату
  30.      <a class="ulink" href="http://php.net/strftime" target="_top">strftime()</a>.
  31.      Даты могут быть переданы Smarty в виде
  32.      <a class="ulink" href="http://php.net/function.time" target="_top">временных меток</a> unix,
  33.      временных меток mysql или в виде любой строки, содержащей день, месяц и
  34.      год, которую может обработать функция
  35.      <a class="ulink" href="http://php.net/strtotime" target="_top">strtotime()</a>.
  36.      Дизайнер могут использовать date_format для получения полного контроля
  37.      над форматированием даты. Если дата, переданная в
  38.      <span class="command"><strong>date_format</strong></span>, пуста и второй аргумент передан, он будет
  39.      использоваться в качестве даты для форматирования.
  40.    </p>
  41. <div class="informaltable"><table border="1">
  42. <colgroup>
  43. <col align="center">
  44. <col align="center">
  45. <col align="center">
  46. <col align="center">
  47. <col>
  48. </colgroup>
  49. <thead><tr>
  50. <th align="center">Позиция параметра</th>
  51. <th align="center">Тип</th>
  52. <th align="center">Обязателен</th>
  53. <th align="center">По умолчанию</th>
  54. <th>Описание</th>
  55. </tr></thead>
  56. <tbody>
  57. <tr>
  58. <td align="center">1</td>
  59. <td align="center">string</td>
  60. <td align="center">Нет</td>
  61. <td align="center">%b %e, %Y</td>
  62. <td>Это формат для обрабатываемой даты.</td>
  63. </tr>
  64. <tr>
  65. <td align="center">2</td>
  66. <td align="center">string</td>
  67. <td align="center">Нет</td>
  68. <td align="center">n/a</td>
  69. <td>Это дата по умолчанию, если входящее значение пустое.</td>
  70. </tr>
  71. </tbody>
  72. </table></div>
  73. <p>
  74.    </p>
  75. <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
  76. <h3 class="title">Note</h3>
  77. <p>
  78.      Начиная со Smarty-2.6.10, числовые значения, передаваемые в date_format,
  79.      <span class="emphasis"><em>всегда</em></span> рассматриваются как временная метка unix
  80.      (кроме временных меток mysql, см. ниже).
  81.     </p>
  82. <p>
  83.      До Smarty-2.6.10, числовые строки, которые так же могли быть обработаны
  84.      функцией strtotime() в php (к примеру, "ГГГГММДД"), иногда - 
  85.      в зависимости от конкретной реализации strtotime() - интерпретировались
  86.      как строки с датой, а не временные метки.
  87.     </p>
  88. <p>
  89.      Единственное исключение - это временные метки mysql: Они так же
  90.      являются числовыми и состоят из 14 символов ("ГГГГММДДЧЧММСС").
  91.      Временные метки mysql имеют более высокий приоритет, чем временные
  92.      метки unix.
  93.     </p>
  94. </div>
  95. <p>
  96.   </p>
  97. <div class="example">
  98. <a name="id2655575"></a><p class="title"><b>Example 5.8. date_format</b></p>
  99. <div class="example-contents">
  100. <pre class="programlisting">
  101.  
  102. &lt;?php
  103.  
  104. $config['date'] = '%I:%M %p';
  105. $config['time'] = '%H:%M:%S';
  106. $smarty-&gt;assign('config',$config);
  107. $smarty-&gt;assign('yesterday', strtotime('-1 day'));
  108.  
  109. ?&gt;
  110.  
  111.    </pre>
  112. <p>
  113.     Шаблон (использует <a class="link" href="language.variables.smarty.html#language.variables.smarty.now" title="{$smarty.now}">$smarty.now</a>):
  114.    </p>
  115. <pre class="programlisting">
  116.  
  117. {$smarty.now|date_format}
  118. {$smarty.now|date_format:"%D"}
  119. {$smarty.now|date_format:$config.date}
  120. {$yesterday|date_format}
  121. {$yesterday|date_format:"%A, %B %e, %Y"}
  122. {$yesterday|date_format:$config.time}
  123.  
  124.    </pre>
  125. <p>
  126.     Результат обработки:
  127.    </p>
  128. <pre class="screen">
  129.  
  130. Feb 6, 2001
  131. 02/06/01
  132. 02:33 pm
  133. Feb 5, 2001
  134. Monday, February 5, 2001
  135. 14:33:00
  136.  
  137.    </pre>
  138. </div>
  139. </div>
  140. <br class="example-break"><p>
  141.    Конверсионные указатели <span class="command"><strong>date_format</strong></span>:
  142.   </p>
  143. <div class="itemizedlist"><ul class="itemizedlist" type="disc">
  144. <li class="listitem"><p>
  145.     %a - сокращенное название дня недели, в зависимости от текущей локали
  146.    </p></li>
  147. <li class="listitem"><p>
  148.     %A - полное название дня недели, в зависимости от текущей локали
  149.    </p></li>
  150. <li class="listitem"><p>
  151.     %b - сокращенное название месяца, в зависимости от текущей локали
  152.    </p></li>
  153. <li class="listitem"><p>
  154.     %B - полное название месяца, в зависимости от текущей локали
  155.    </p></li>
  156. <li class="listitem"><p>
  157.     %c - формат даты и времени по умолчанию для текущей локали
  158.    </p></li>
  159. <li class="listitem"><p>
  160.     %C - номер века (год, деленный на 100, представленный в виде целого в промежутке от 00 до 99)
  161.    </p></li>
  162. <li class="listitem"><p>
  163.     %d - день месяца в десятичном формате (от 01 до 31)
  164.    </p></li>
  165. <li class="listitem"><p>
  166.     %D - синоним %m/%d/%y
  167.    </p></li>
  168. <li class="listitem"><p>
  169.     %e - день месяца в десятичном формате без ведущего нуля (от 1 до 31)
  170.    </p></li>
  171. <li class="listitem"><p>
  172.     %g - Week-based year within century [00,99]
  173.    </p></li>
  174. <li class="listitem"><p>
  175.     %G - Week-based year, including the century [0000,9999]
  176.    </p></li>
  177. <li class="listitem"><p>
  178.     %h - синоним %b
  179.    </p></li>
  180. <li class="listitem"><p>
  181.     %H - часы по 24-часовым часам (от 00 до 23)
  182.    </p></li>
  183. <li class="listitem"><p>
  184.     %I - часы по 12-часовым часам (от 01 до 12)
  185.    </p></li>
  186. <li class="listitem"><p>
  187.     %j - день года (от 001 до 366)
  188.    </p></li>
  189. <li class="listitem"><p>
  190.     %k - часы по 24-часовым часам без ведущего нуля (от 0 до 23)
  191.    </p></li>
  192. <li class="listitem"><p>
  193.     %l - часы по 12-часовым часам без ведущего нуля (от 1 до 12)
  194.    </p></li>
  195. <li class="listitem"><p>
  196.     %m - номер месяца (от 01 до 12)
  197.    </p></li>
  198. <li class="listitem"><p>
  199.     %M - минуты
  200.    </p></li>
  201. <li class="listitem"><p>
  202.     %n - символ новой строки
  203.    </p></li>
  204. <li class="listitem"><p>
  205.     %p - `am' или `pm', в зависимости от заданного формата времени и текущей локали.
  206.    </p></li>
  207. <li class="listitem"><p>
  208.     %r - time in a.m. and p.m. notation
  209.    </p></li>
  210. <li class="listitem"><p>
  211.     %R - time in 24 hour notation
  212.    </p></li>
  213. <li class="listitem"><p>
  214.     %S - секунды
  215.    </p></li>
  216. <li class="listitem"><p>
  217.     %t - символ табуляции
  218.    </p></li>
  219. <li class="listitem"><p>
  220.     %T - время в формате %H:%M:%S
  221.    </p></li>
  222. <li class="listitem"><p>
  223.     %u - номер дня недели [1,7], где 1-ый день - понедельник
  224.    </p></li>
  225. <li class="listitem"><p>
  226.     %U - номер недели в году, считая первое воскресенья года первым днем первой недели
  227.    </p></li>
  228. <li class="listitem"><p>
  229.     %V - номер недели в году (по ISO 8601:1988) в диапазоне от 01 до 53, где первая неделя
  230.     та, у которой хотя бы 4 дня находятся в данном году. Понедельник считается
  231.  	  первым днем недели.
  232.    </p></li>
  233. <li class="listitem"><p>
  234.     %w - номер дня недели, где 0 - воскресенье
  235.    </p></li>
  236. <li class="listitem"><p>
  237.     %W - номер недели в году, считаю первый понедельник первым днем первой недели.
  238.    </p></li>
  239. <li class="listitem"><p>
  240.     %x - предпочтительное представление даты для текущих настроек locale без времени
  241.    </p></li>
  242. <li class="listitem"><p>
  243.     %X - предпочтительное представление времени для текущих настроек locale без даты
  244.    </p></li>
  245. <li class="listitem"><p>
  246.     %y - год в виде десятичного числа без века (от 00 до 99)
  247.    </p></li>
  248. <li class="listitem"><p>
  249.     %Y - год в виде десятичного числа включая век
  250.    </p></li>
  251. <li class="listitem"><p>
  252.     %Z - часовой пояс или имя или сокращение
  253.    </p></li>
  254. <li class="listitem"><p>
  255.     %% - буквальный символ `%'
  256.    </p></li>
  257. </ul></div>
  258. <p>
  259.    </p>
  260. <div class="note" title="Замечание для программистов" style="margin-left: 0.5in; margin-right: 0.5in;">
  261. <h3 class="title">Замечание для программистов</h3>
  262. <p>
  263.      <span class="command"><strong>date_format</strong></span> является обычной оберткой для функции
  264.      PHP <a class="ulink" href="http://php.net/strftime" target="_top">strftime()</a>.
  265.      Вы можете располагать б<span class="emphasis"><em>о</em></span>льш или меньшим количеством
  266.      доступных конверсионных указателей в зависимости от функции
  267.      <a class="ulink" href="http://php.net/strftime" target="_top">strftime()</a> той системы,
  268.      где был скомпилирован PHP. Обратитесь к руководству вашей системы для
  269.      получения полного списка доступных указателей.
  270.     </p>
  271. </div>
  272. <p>
  273.   </p>
  274. <p>
  275.    См. также
  276.    <a class="link" href="language.variables.smarty.html#language.variables.smarty.now" title="{$smarty.now}">$smarty.now</a>,
  277.    <a class="ulink" href="http://php.net/strftime" target="_top">функция php strftime()</a>,
  278.    <a class="link" href="language.function.html.select.date.html" title="{html_select_date}">{html_select_date}</a>
  279.    и
  280.    <a class="link" href="tips.dates.html" title="Даты">даты</a>.
  281.   </p>
  282. </div>
  283. <div class="navfooter">
  284. <hr>
  285. <table width="100%" summary="Navigation footer">
  286. <tr>
  287. <td width="40%" align="left">
  288. <a accesskey="p" href="language.modifier.count.words.html">Prev</a> </td>
  289. <td width="20%" align="center"><a accesskey="u" href="language.modifiers.html">Up</a></td>
  290. <td width="40%" align="right"> <a accesskey="n" href="language.modifier.default.html">Next</a>
  291. </td>
  292. </tr>
  293. <tr>
  294. <td width="40%" align="left" valign="top">count_words </td>
  295. <td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
  296. <td width="40%" align="right" valign="top"> default</td>
  297. </tr>
  298. </table>
  299. </div>
  300. </body>
  301. </html>