cvs: phpdoc-ru /reference/datetime reference.xml /reference/datetime/functions checkdate.xml date.xml getdate.xml gettimeofday.xml gmdate.xml
gmmktime.xml gmstrftime.xml localtime.xml microtime.xml mktime.xml strftime.xml strtotime.xml time.xml
| From: | Antony Dovgal | Date: | Wed, 24 Mar 2004 11:45:36 +0000 |
| Subject: | cvs: phpdoc-ru /reference/datetime reference.xml /reference/datetime/functions checkdate.xml date.xml getdate.xml gettimeofday.xml gmdate.xml gmmktime.xml gmstrftime.xml localtime.xml microtime.xml mktime.xml strftime.xml strtotime.xml time.xml |
||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-258@lists.php.net to get a copy of this message | ||
tony2001 Wed Mar 24 06:45:36 2004 EDT
Added files:
/phpdoc-ru/reference/datetime reference.xml
/phpdoc-ru/reference/datetime/functions checkdate.xml date.xml
getdate.xml
gettimeofday.xml gmdate.xml
gmmktime.xml gmstrftime.xml
localtime.xml microtime.xml
mktime.xml strftime.xml
strtotime.xml time.xml
Log:
add Datetime reference (translated by Andrey Demenev)
http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/reference.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/reference.xml +++ phpdoc-ru/reference/datetime/reference.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.6 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <reference id="ref.datetime"> <title>Ôóíêöèè äëÿ ðàáîòû ñ äàòîé è âðåìåíåì</title> <titleabbrev>Äàòà è âðåìÿ</titleabbrev> <partintro> <section id="datetime.intro"> &reftitle.intro; <para> Ýòè ôóíêöèè ïîçâîëÿþò ïîëó÷èòü äàòó è âðåìÿ íà ñåðâåðå, ãäå âûïîëíÿåòñÿ PHP ñêðèïò. Èñïîëüçóÿ ýòè ôóíêöèè, äàòó è âðåìÿ ìîæíî ïðåäñòàâèòü â ðàçëè÷íûõ ôîðìàòàõ. </para> <note> <simpara> Îáðàòèòå âíèìàíèå, ÷òî ðàáîòà ýòèõ ôóíêöèé çàâèñèò îò òåêóùåé ëîêàëè íà ñåðâåðå. Òàêæå ñëåäóåò ïðèíèìàòü âî âíèìàíèå ëåòíåå âðåìÿ è âèñîêîñíûå ãîäû. </simpara> </note> </section> <section id="datetime.required"> &reftitle.required; &no.requirement; </section> <section id="datetime.installation"> &reftitle.install; &no.install; </section> <section id="datetime.runtime"> &reftitle.runtime; &no.config; </section> <section id="datetime.resources"> &reftitle.resources; &no.resource; </section> <section id="datetime.constants"> &reftitle.constants; &no.constants; </section> </partintro> &reference.datetime.functions; </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/checkdate.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/checkdate.xml +++ phpdoc-ru/reference/datetime/functions/checkdate.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.checkdate"> <refnamediv> <refname>checkdate</refname> <refpurpose>Ïðîâåðÿåò ïðàâèëüíîñòü äàòû ïî ãðåãîðèàíñêîìó êàëåíäàðþ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>bool</type><methodname>checkdate</methodname> <methodparam><type>int</type><parameter>month</parameter></methodparam> <methodparam><type>int</type><parameter>day</parameter></methodparam> <methodparam><type>int</type><parameter>year</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò &true; åñëè äàòà, çàäàííàÿ àðãóìåíòàìè, ÿâëÿåòñÿ ïðàâèëüíîé; èíà÷å âîçâðàùàåò &false;. Äàòà ñ÷èòàåòñÿ ïðàâèëüíîé, åñëè: <itemizedlist> <listitem> <simpara> ãîä â äèàïàçîíå îò 1 äî 32767 âêëþ÷èòåëüíî </simpara> </listitem> <listitem> <simpara> ìåñÿö â äèàïàçîíå îò 1 äî 12 âêëþ÷èòåëüíî </simpara> </listitem> <listitem> <simpara> <parameter>day</parameter> ÿâëÿåòñÿ äîïóñòèìûì íîìåðîì äíÿ äëÿ ìåñÿöà, çàäàííîãî àðãóìåíòîì <parameter>month</parameter>, ïðèíèìàÿ âî âíèìàíèå,÷òî <parameter>year</parameter> ìîæåò çàäàâàòü âèñîêîñíûé ãîä. </simpara> </listitem> </itemizedlist> </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>checkdate</function></title> <programlisting role="php"> <![CDATA[ <?php var_dump(checkdate(12, 31, 2000)); var_dump(checkdate(2, 29, 2001)); ?> ]]> </programlisting> <para> Ïðèâåäåííûé âûøå ïðèìåð âûâåäåò: </para> <screen> <![CDATA[ bool(true) bool(false) ]]> </screen> </example> </para> <para> Ñì.òàêæå îïèñàíèå ôóíêöèé <function>mktime</function> è <function>strtotime</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/date.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/date.xml +++ phpdoc-ru/reference/datetime/functions/date.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.15 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.date"> <refnamediv> <refname>date</refname> <refpurpose>Ôîðìàòèðóåò ñèñòåìíóþ äàòó/âðåìÿ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>string</type><methodname>date</methodname> <methodparam><type>string</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter> timestamp </parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò âðåìÿ, îòôîðìàòèðîâàííîå â ñîîòâåòñòâèè ñ àðãóìåíòîì <parameter>format</parameter>, èñïîëüçóÿ ìåòêó âðåìåíè, çàäàííóþ àðãóìåíòîì <parameter>timestamp</parameter> èëè òåêóùåå ñèñòåìíîå âðåìÿ, åñëè <parameter>timestamp</parameter> íå çàäàí. Äðóãèìè ñëîâàìè, <parameter>timestamp</parameter> ÿâëÿåòñÿ íåîáÿçàòåëüíûì è ïî óìîë÷àíèþ ðàâåí çíà÷åíèþ, âîçâðàùàåìîìó ôóíêöèåé <function>time</function>. <note> <para> Äëÿ áîëüøèíñòâà ñèñòåì äîïóñòèìûìè ÿâëÿþòñÿ äàòû ñ 13 äåêàáðÿ 1901, 20:45:54 GMT ïî 19 ÿíâàðÿ 2038, 03:14:07 GMT. (Ýòè äàòû ñîîòâåòñòâóþò ìèíèìàëüíîìó è ìàêñèìàëüíîìó çíà÷åíèþ 32-áèòîâîãî öåëîãî ñî çíàêîì). Äëÿ Windows äîïóñòèìû äàòû ñ 01-01-1970 ïî 19-01-2038. </para> </note> <note> <para> Äëÿ ïîëó÷åíèÿ ìåòêè âðåìåíè èç ñòðîêîâîãî ïðåäñòàâëåíèÿ äàòû ìîæíî èñïîëüçîâàòü ôóíêöèþ <function>strtotime</function>. Êðîìå òîãî, íåêîòîðûå áàçû äàííûõ èìåþò ñîáñòâåííûå ôóíêöèè äëÿ ïðåîáðàçîâàíèÿ âíóòðåííåãî ïðåäñòàâëåíèÿ äàòû â ìåòêó âðåìåíè (íàïðìåð, ôóíêöèÿ MySQL <ulink url="&url.mysql.docs.date;">UNIX_TIMESTAMP</ulink>). </para> </note> </para> <para> <table> <title> ïàðàìåòðå <parameter>format</parameter> ðàñïîçíàþòñÿ ñëåäóþùèå ñèìâîëû </title> <tgroup cols="3"> <thead> <row> <entry>Ñèìâîë â ñòðîêå <parameter>format</parameter></entry> <entry>Îïèñàíèå</entry> <entry>Ïðèìåð âîçâðàùàåìîãî çíà÷åíèÿ</entry> </row> </thead> <tbody> <row> <entry><literal>a</literal></entry> <entry>Ante meridiem èëè Post meridiem â íèæíåì ðåãèñòðå</entry> <entry><literal>am</literal> èëè <literal>pm</literal></entry> </row> <row> <entry><literal>A</literal></entry> <entry>Ante meridiem èëè Post meridiem â âåðõíåì ðåãèñòðå</entry> <entry><literal>AM</literal> èëè <literal>PM</literal></entry> </row> <row> <entry><literal>B</literal></entry> <entry>Âðåìÿ â ñòàäàðòå Swatch Internet</entry> <entry>Îò <literal>000</literal> äî <literal>999</literal></entry> </row> <row> <entry><literal>c</literal></entry> <entry>Äàòà â ôîðìàòå ISO 8601 (äîáàâëåíî â PHP 5)</entry> <entry>2004-02-12T15:19:21+00:00</entry> </row> <row> <entry><literal>d</literal></entry> <entry>Äåíü ìåñÿöà, 2 öèôðû ñ âåäóùèìè íóëÿìè</entry> <entry>îò <literal>01</literal> äî <literal>31</literal></entry> </row> <row> <entry><literal>D</literal></entry> <entry>Ñîêðàùåííîå íàèìåíîâàíèå äíÿ íåäåëè, 3 ñèìâîëà</entry> <entry>îò <literal>Mon</literal> äî <literal>Sun</literal></entry> </row> <row> <entry><literal>F</literal></entry> <entry>Ïîëíîå íàèìåíîâàíèå ìåñÿöà, íàïðèìåð January èëè March</entry> <entry>îò <literal>January</literal> äî <literal>December</literal></entry> </row> <row> <entry><literal>g</literal></entry> <entry>×àñû â 12-÷àñîâîì ôîðìàòå áåç âåäóùèõ íóëåé</entry> <entry>Îò <literal>1</literal> äî <literal>12</literal></entry> </row> <row> <entry><literal>G</literal></entry> <entry>×àñû â 24-÷àñîâîì ôîðìàòå áåç âåäóùèõ íóëåé</entry> <entry>Îò <literal>0</literal> äî <literal>23</literal></entry> </row> <row> <entry><literal>h</literal></entry> <entry>×àñû â 12-÷àñîâîì ôîðìàòå ñ âåäóùèìè íóëÿìè</entry> <entry>Îò <literal>01</literal> äî <literal>12</literal></entry> </row> <row> <entry><literal>H</literal></entry> <entry>×àñû â 24-÷àñîâîì ôîðìàòå ñ âåäóùèìè íóëÿìè</entry> <entry>Îò <literal>00</literal> äî <literal>23</literal></entry> </row> <row> <entry><literal>i</literal></entry> <entry>Ìèíóòû ñ âåäóùèìè íóëÿìè</entry> <entry><literal>00</literal> to <literal>59</literal></entry> </row> <row> <entry><literal>I</literal> (çàãëàâíàÿ i)</entry> <entry>Ïðèçíàê ëåòíåãî âðåìåíè</entry> <entry><literal>1</literal>, åñëè äàòà ñîîòâåòñòâóåò ëåòíåìó âðåìåíè, èíà÷å <literal>0</literal> otherwise.</entry> </row> <row> <entry><literal>j</literal></entry> <entry>Äåíü ìåñÿöà áåç âåäóùèõ íóëåé</entry> <entry>Îò <literal>1</literal> äî <literal>31</literal></entry> </row> <row> <entry><literal>l</literal> (ñòðî÷íàÿ 'L')</entry> <entry>Ïîëíîå íàèìåíîâàíèå äíÿ íåäåëè</entry> <entry>Îò <literal>Sunday</literal> äî <literal>Saturday</literal></entry> </row> <row> <entry><literal>L</literal></entry> <entry>Ïðèçíàê âèñîêîñíîãî ãîäà</entry> <entry><literal>1</literal>, åñëè ãîä âèñîêîñíûé, èíà÷å <literal>0</literal>.</entry> </row> <row> <entry><literal>m</literal></entry> <entry>Ïîðÿäêîâûé íîìåð ìåñÿöà ñ âåäóùèìè íóëÿìè</entry> <entry>Îò <literal>01</literal> äî <literal>12</literal></entry> </row> <row> <entry><literal>M</literal></entry> <entry>Ñîêðàùåííîå íàèìåíîâàíèå ìåñÿöà, 3 ñèìâîëà</entry> <entry>Îò <literal>Jan</literal> äî <literal>Dec</literal></entry> </row> <row> <entry><literal>n</literal></entry> <entry>Ïîðÿäêîâûé íîìåð ìåñÿöà áåç âåäóùèõ íóëåé</entry> <entry>Îò <literal>1</literal> äî <literal>12</literal></entry> </row> <row> <entry><literal>O</literal></entry> <entry>Ðàçíèöà ñ âðåìåíåì ïî Ãðèíâè÷ó â ÷àñàõ</entry> <entry>Íàïðèìåð: <literal>+0200</literal></entry> </row> <row> <entry><literal>r</literal></entry> <entry>Äàòà â ôîðìàòå <ulink url="&url.rfc;2822">RFC 2822</ulink></entry> <entry>Íàïðèìåð: <literal>Thu, 21 Dec 2000 16:01:07 +0200</literal></entry> </row> <row> <entry><literal>s</literal></entry> <entry>Ñåêóíäû ñ âåäóùèìè íóëÿìè</entry> <entry>Îò <literal>00</literal> äî <literal>59</literal></entry> </row> <row> <entry><literal>S</literal></entry> <entry>Àíãëèéñêèé ñóôôèêñ ïîðÿäêîâîãî ÷èñëèòåëüíîãî äíÿ ìåñÿöà, 2 ñèìâîëà</entry> <entry> <literal>st</literal>, <literal>nd</literal>, <literal>rd</literal> èëè <literal>th</literal>. Ïðèìåíÿåòñÿ ñîâìåñòíî ñ <literal>j</literal> </entry> </row> <row> <entry><literal>t</literal></entry> <entry>Êîëè÷åñòâî äíåé â ìåñÿöå</entry> <entry>Îò <literal>28</literal> äî <literal>31</literal></entry> </row> <row> <entry><literal>T</literal></entry> <entry>Âðåìåííàÿ çîíà íà ñåðâåðå</entry> <entry>Ïðèìåðû: <literal>EST</literal>, <literal>MDT</literal> ...</entry> </row> <row> <entry><literal>U</literal></entry> <entry>Êîëè÷åñòâî ñåêóíä, ïðîøåäøèõ ñ íà÷àëà Ýðû Unix (1 ÿíâàðÿ 1970, 00:00:00 GMT)</entry> <entry>Ñì. òàêæå <function>time</function></entry> </row> <row> <entry><literal>w</literal></entry> <entry>Ïîðÿäêîâûé íîìåð äíÿ íåäåëè</entry> <entry>Îò <literal>0</literal> (âîñêðåñåíüå) äî <literal>6</literal> (ñóááîòà)</entry> </row> <row> <entry><literal>W</literal></entry> <entry>Ïîðÿäêîâûé íîìåð íåäåëè ãîäà ïî ISO-8601, ïåðâûé äåíü íåäåëè - ïîíåäåëüíèê (äîáàâëåíî â PHP 4.1.0)</entry> <entry>Íàïðèìåð: <literal>42</literal> (42-ÿ íåäåëÿ ãîäà)</entry> </row> <row> <entry><literal>Y</literal></entry> <entry>Ïîðÿäêîâûé íîìåð ãîäà, 4 öèôðû</entry> <entry>Ïðèìåðû: <literal>1999</literal>, <literal>2003</literal></entry> </row> <row> <entry><literal>y</literal></entry> <entry>Íîìåð ãîäà, 2 öèôðû</entry> <entry>Ïðèìåðû: <literal>99</literal>, <literal>03</literal></entry> </row> <row> <entry><literal>z</literal></entry> <entry>Ïîðÿäêîâûé íîìåð äíÿ â ãîäó (íóìåðàöèÿ ñ 0)</entry> <entry>Îò <literal>0</literal> äî <literal>365</literal></entry> </row> <row> <entry><literal>Z</literal></entry> <entry>Ñìåùåíèå âðåìåííîé çîíû â ñåêóíäàõ. Äëÿ âðåìåííûõ çîí çàïàäíåå UTC ýòî îòðèöàòåëüíîå ÷èñëî, âîñòî÷íåå UTC - ïîëîæèòåëüíîå.</entry> <entry>Îò <literal>-43200</literal> äî <literal>43200</literal></entry> </row> </tbody> </tgroup> </table> </para> <para> Ëþáûå äðóãèå ñèìâîëû, âñòðå÷åííûå â ñòðîêå <parameter>format</parameter>, áóäóò âûâåäåíû â ðåçóëüòèðóþùóþ ñòðîêó áåç èçìåíåíèé. <literal>Z</literal> âñåãäà âîçâðàùàåò <literal>0</literal> ïðè èñïîëüçîâàíèè <function>gmdate</function>. </para> <para> <example> <title>Ïðèìåðû èñïîëüçîâàíèÿ ôóíêöèè <function>date</function></title> <programlisting role="php"> <![CDATA[ <?php // âûâîä äíÿ íåäåëè, íàïðèìåð Wednesday echo date("l"); // âûâîä äàòû â ôîðìàòå: Wednesday 15th of January 2003 05:51:38 AM echo date("l dS of F Y h:i:s A"); // âûâîä: July 1, 2000 is on a Saturday echo "July 1, 2000 is on a " . date("l", mktime(0, 0, 0, 7, 1, 2000)); ?> ]]> </programlisting> </example> </para> <para> Èçáåæàòü ðàñïîçíàâàíèÿ ñèìâîëà êàê ôîðìàòèðóþùåãî ìîæíî, åñëè ýêðàíèðîâàòü ýòîò ñèìâîë ñ ïîìîùüþ <literal>\</literal> Åñëè â ñî÷åòàíèè ñ <literal>\</literal> ñèìâîë ÿâëÿååñÿ ñïåöèàëüíûì (íàïðèìåð, <literal>\t</literal>), ñëåäóåò äîáàâëÿòü åùå îäèí <literal>\</literal>. <example> <title>Ýêðàíèðîâàíèå ñèìâîëîâ â ôóíêöèè <function>date</function></title> <programlisting role="php"> <![CDATA[ <?php // âûâîä: Wednesday the 15th echo date("l \\t\h\e jS"); ?> ]]> </programlisting> </example> </para> <para> Ôóíêöèè <function>date</function> è <function>mktime</function> äëÿ âûâîäà ïðîøåäøèõ è áóäóùèõ äàò. <example> <title> <function>date</function> è <function>mktime</function> example </title> <programlisting role="php"> <![CDATA[ <?php $tomorrow = mktime(0, 0, 0, date("m") , date("d")+1, date("Y")); $lastmonth = mktime(0, 0, 0, date("m")-1, date("d"), date("Y")); $nextyear = mktime(0, 0, 0, date("m"), date("d"), date("Y")+1); ?> ]]> </programlisting> </example> <note> <para> Ëó÷øå âû÷èòàòü èëè ïðèáàâëÿòü êîëè÷åñòâî ñåêóíä â äíå èëè ìåñÿöå ê ê ìåòêå âðåìåíè, òàê êàê ïðèýòîì áóäåò ó÷òåí ïåðåõîä íà ëåòíåå âðåìÿ. </para> </note> </para> <para> Ïðèâåäåì åùå íåñêîëüêî ïðèìåðîâ èñïîëüçîâàíèÿ ôóíêöèè <function>date</function>. Ïîìíèòå, ÷òî ñëåäóåò ýêðàíèðîâàòü âñå ñèìâîëû, êîòîðûå âû õîòèòå âèäåòü â ðåçóëüòàòå ðàáîòû ôóíêöèè áåç èçìåíåíèé. Ýòî îòíîñèòñÿ è ê ñèìâîëàì, êîòîðûå â òåêóùåé âåðñèè PHP íå ðàñïîçíàþòñÿ êàê ñïåöèàëüíûå, òàê êàê ýòèì ñèìâîëàì ìîæåò áûòü íàçíà÷åíî çíà÷åíèå â ñëåäóþùèõ âåðñèÿõ. Èñïîëüçóéòå îäèíàðíûå êàâû÷êè äëÿ ïðåäîòâðàùåíèÿ ïðåîáðàçîâàíèÿ \n â ïåðåâîä ñòðîêè. <example> <title> Ôîðìàòèðîâàíèå ñ èñïîëüçîâàíèåì <function>date</function> </title> <programlisting role="php"> <![CDATA[ <?php // Ïðåäïîëîæèì, ÷òî òåêóùàÿ äàòà March 10th, 2001, 5:16:18 pm $today = date("F j, Y, g:i a"); // March 10, 2001, 5:16 pm $today = date("m.d.y"); // 03.10.01 $today = date("j, n, Y"); // 10, 3, 2001 $today = date("Ymd"); // 20010310 $today = date('h-i-s, j-m-y, it is w Day z '); // 05-16-17, 10-03-01, 1631 1618 6 Fripm01 $today = date('\i\t \i\s \t\h\e jS \d\a\y.'); // It is the 10th day. $today = date("D M j G:i:s T Y"); // Sat Mar 10 15:16:08 MST 2001 $today = date('H:m:s \m \i\s\ \m\o\n\t\h'); // 17:03:17 m is month $today = date("H:i:s"); // 17:16:17 ?> ]]> </programlisting> </example> </para> <para> Äëÿ ôîðìàòèðîâàíèÿ äàò íà äðóãèõ ÿçûêàõ èñïîëüçóéòå ôóíêöèè <function>setlocale</function> è <function>strftime</function>. </para> <para> Ñì. òàêæå îïèñàíèå ôóíêöèé <function>getlastmod</function>, <function>gmdate</function>, <function>mktime</function>, <function>strftime</function> è <function>time</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/getdate.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/getdate.xml +++ phpdoc-ru/reference/datetime/functions/getdate.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.8 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.getdate"> <refnamediv> <refname>getdate</refname> <refpurpose>Âîçâðàùàåò èíôîðìàöèþ î äàòå/âðåìåíè</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>array</type><methodname>getdate</methodname> <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò àññîöèàòèâíûé ìàññèâ, ñîäåðæàùèé èíôîðìàöèþ î äàòå, ïðåäñòàâëåííîé ìåòêîé âðåìåíè <parameter>timestamp</parameter> èëè òåêóùåì ñèñòåìíîì âðåìåíè, åñëè <parameter>timestamp</parameter> íå ïåðåäàí. Ìàññèâ ñîäåðæèò ñëåäóþùèå ýëåìåíòû: </para> <para> <table> <title>Èíäåêñû âîçâðàùàåìîãî àññîöèàòèâíîãî ìàññèâà</title> <tgroup cols="3"> <thead> <row> <entry>Èíäåêñ</entry> <entry>Îïèñàíèå</entry> <entry>Ïðèìåð çíà÷åíèÿ</entry> </row> </thead> <tbody> <row> <entry><literal>"seconds"</literal></entry> <entry>Ñåêóíäû</entry> <entry>Îò <literal>0</literal> äî <literal>59</literal></entry> </row> <row> <entry><literal>"minutes"</literal></entry> <entry>Ìèíóòû</entry> <entry>Îò <literal>0</literal> äî <literal>59</literal></entry> </row> <row> <entry><literal>"hours"</literal></entry> <entry>×àñû</entry> <entry>Îò <literal>0</literal> äî <literal>23</literal></entry> </row> <row> <entry><literal>"mday"</literal></entry> <entry>Ïîðÿäêîâûé íîìåð äíÿ ìåñÿöà</entry> <entry>Îò <literal>1</literal> äî <literal>31</literal></entry> </row> <row> <entry><literal>"wday"</literal></entry> <entry>Ïîðÿäêîâûé íîìåð äíÿ </entry> <entry>Îò <literal>0</literal> (âîñêðåñåíüå) äî <literal>6</literal> (ñóááîòà)</entry> </row> <row> <entry><literal>"mon"</literal></entry> <entry>Ïîðÿäêîâûé íîìåð ìåñÿöà</entry> <entry>Îò <literal>1</literal> äî <literal>12</literal></entry> </row> <row> <entry><literal>"year"</literal></entry> <entry>Ïîðÿäêîâûé íîìåð ãîäà, 4 öèôðû</entry> <entry>Ïðèìåðû: <literal>1999</literal>, <literal>2003</literal></entry> </row> <row> <entry><literal>"yday"</literal></entry> <entry>Ïîðÿäêîâûé íîìåð äíÿ â ãîäó (íóìåðàöèÿ ñ 0)</entry> <entry>Îò <literal>0</literal> äî <literal>366</literal></entry> </row> <row> <entry><literal>"weekday"</literal></entry> <entry>Ïîëíîå íàèìåíîâàíèå äíÿ íåäåëè</entry> <entry>Îò <literal>Sunday</literal> äî <literal>Saturday</literal></entry> </row> <row> <entry><literal>"month"</literal></entry> <entry>Ïîëíîå íàèìåíîâàíèå ìåñÿöà, íàïðèìåð January èëè March</entry> <entry>îò <literal>January</literal> äî <literal>December</literal></entry> </row> <row> <entry><literal>0</literal></entry> <entry>Êîëè÷åñêòâî ñåêóíä, ïðîøåäøèõ ñ íà÷àëà Ýðû Unix, ïîäîáíî çíà÷åíèþ, âîçâðàùàåìîìó ôóíêöèåé <function>time</function> è èñïîëüçóåìîìó ôóíêöèåé <function>date</function>.</entry> <entry>Ïëàòôîðìî-çàâèñèìîå, â áîëüøèíñòâå ñëó÷àåâ îò <literal>-2147483648</literal> äî <literal>2147483647</literal>. </entry> </row> </tbody> </tgroup> </table> </para> <para> <example> <title> Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>getdate</function> </title> <programlisting role="php"> <![CDATA[ <?php $today = getdate(); print_r($today); ?> ]]> </programlisting> <para> Âûâîä áóäåò âûãëÿäåòü òàê: </para> <screen> <![CDATA[ Array ( [seconds] => 40 [minutes] => 58 [hours] => 21 [mday] => 17 [wday] => 2 [mon] => 6 [year] => 2003 [yday] => 167 [weekday] => Tuesday [month] => June [0] => 1055901520 ) ]]> </screen> </example> </para> <para> See also <function>date</function>, <function>time</function>, and <function>setlocale</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/gettimeofday.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/gettimeofday.xml +++ phpdoc-ru/reference/datetime/functions/gettimeofday.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.3 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.gettimeofday"> <refnamediv> <refname>gettimeofday</refname> <refpurpose>Âîçâðàùàåò òåêóùåå âðåìÿ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>array</type><methodname>gettimeofday</methodname> <void/> </methodsynopsis> <para> Ýòà ôóíêöèÿ ÿâëÿåòñÿ èíòåðôåéñîì ê ñèñòåìíîìó âûçîâó gettimeofday(2). Îíà âîçâðàùàåò àññîöèàòèâíûé ìàññèâ, ñîäåðæàùèé èíôîðìàöèþ, ïîëó÷åííóþ îò ñèñòåìíîé ôóíêöèè. <itemizedlist> <listitem> <simpara> "sec" - ñåêóíäû </simpara> </listitem> <listitem> <simpara> "usec" - ìèêðîñåêóíäû </simpara> </listitem> <listitem> <simpara> "minuteswest" - ñìåùåíèå ê çàïàäó îò Ãðèíâè÷à, â ìèíóòàõ </simpara> </listitem> <listitem> <simpara> "dsttime" - òèï êîððåêöèè ëåòíåãî âðåìåíè </simpara> </listitem> </itemizedlist> </para> <para> <example> <title> Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>gettimeofday</function> </title> <programlisting role="php"> <![CDATA[ <?php print_r(gettimeofday()); ?> ]]> </programlisting> <para> Âûâîä áóäåò âûãëÿäåòü òàê: </para> <screen> <![CDATA[ Array ( [sec] => 1073504408 [usec] => 238215 [minuteswest] => 0 [dsttime] => 1 ) ]]> </screen> </example> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/gmdate.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/gmdate.xml +++ phpdoc-ru/reference/datetime/functions/gmdate.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.8 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.gmdate"> <refnamediv> <refname>gmdate</refname> <refpurpose>Ôîðìàòèðóåò äàòó/âðåìÿ ïî Ãðèíâè÷ó</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>string</type><methodname>gmdate</methodname> <methodparam><type>string</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam> </methodsynopsis> <para> Ýòà ôóíêöèÿ èäåíòè÷íà ôóíêöèè <function>date</function> çà èñêëþ÷åíèåì òîãî, ÷òî âîçâðàùàåò âðåìÿ ïî Ãðèíâè÷ó (GMT). Íàïðèìåð, â Ôèíëÿíäèè (GMT +0200), ïåðâàÿ ñòðîêà â ñëåäóþùåì ïðèìåðå âûâåäåò "Jan 01 1998 00:00:00", à âòîðàÿ - "Dec 31 1997 22:00:00". <example> <title><function>gmdate</function> example</title> <programlisting role="php"> <![CDATA[ <?php echo date("M d Y H:i:s", mktime(0, 0, 0, 1, 1, 1998)); echo gmdate("M d Y H:i:s", mktime(0, 0, 0, 1, 1, 1998)); ?> ]]> </programlisting> </example> </para> <note> <para>  ñåìåéñòâå ÎÑ Microsoft Windows ñèñòåìíûå áèáëèîòåêè, ðåàëèçóþùèå ýòó ôóíêöèþ, ñîäåðæàò îøèáêè, ïîýòîìó ôóíêöèÿ <function>gmdate</function> íà ýòèõ ñèñòåìàõ íå ïîääåðæèâàåò îòðèöàòåëüíûå çíà÷åíèÿ àðãóìåíòà <parameter>timestamp</parameter>. Äëÿ áîëåå ïîäðîáíîé èíôîðìàöèè, ñì. ñîîáùåíèÿ îá îøèáêàõ: <ulink url="&url.php.bugs;22620">#22620</ulink>, <ulink url="&url.php.bugs;22457">#22457</ulink>, è <ulink url="&url.php.bugs;14391">#14391</ulink>. </para> <para>  îïåðàöèîííûõ ñèñòåìàõ Unix/Linux ýòà ïðîáëåìà íå âîçíèêàåò, òàê êàê ñèñòåìíûå áèáëèîòåêè â ýòèõ ñèñòåìàõ ðåàëèçîâàíû êîððåêòíî. </para> <para> PHP íå ìîæåò èñïðàâèòü îøèáêè â ñèñòåìíûõ áèáëèîòåêàõ. Äëÿ ðåøåíèÿ ýòîé è ïîäîáíûõ ïðîáëåì îáðàùàéòåñü ê ïðîèçâîäèòåëþ îïåðàöèîííîé ñèñòåìû. </para> </note> <para> Ñì. òàêæå îïèñàíèå ôóíêöèé <function>date</function>, <function>mktime</function>, <function>gmmktime</function> è <function>strftime</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/gmmktime.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/gmmktime.xml +++ phpdoc-ru/reference/datetime/functions/gmmktime.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.4 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.gmmktime"> <refnamediv> <refname>gmmktime</refname> <refpurpose>Âîçâðàùàåò ìåòêó âðåìåíè Unix äëÿ âðåìåíè ïî Ãðèíâè÷ó</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>gmmktime</methodname> <methodparam choice="opt"><type>int</type><parameter>hour</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>minute</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>second</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>month</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>day</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>is_dst</parameter></methodparam> </methodsynopsis> <para> Ýòà ôóíêöèÿ èäåíòè÷íà ôóíêöèè <function>mktime</function>, çà èñêëþ÷åíèåì òîãî, ÷òî àðãóìåíòû ôîðìèðóþò âðåìÿ ïî Ãðèíâè÷ó (GMT). </para> <para> Ïîäîáíî ôóíêöèè <function>mktime</function>, àðãóìåíòû ìîãóò áûòü îïóùåíû â ïîðÿäêå ñïðàâà íàëåâî , â ýòîì ñëó÷àå îíè ïðåäïîëàãàþòñÿ ðàâíûìè ñîîòâåòñòâóþùèì êîìïîíåíòàì òåêóùåãî âðåìåíè ïî Ãðèíâè÷ó. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/gmstrftime.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/gmstrftime.xml +++ phpdoc-ru/reference/datetime/functions/gmstrftime.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.7 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.gmstrftime"> <refnamediv> <refname>gmstrftime</refname> <refpurpose>Ôîðìàòèðóåò äàòó/âðåìÿ ïî Ãðèíâè÷ó ñ ó÷åòîì òåêóùåé ëîêàëè</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>string</type><methodname>gmstrftime</methodname> <methodparam><type>string</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam> </methodsynopsis> <para> Ýòà ôóíêöèÿ èäåíòè÷íà ôóíêöèè <function>strftime</function> çà èñêëþ÷åíèåì òîãî, ÷òî âîçâðàùàåò âðåìÿ ïî Ãðèíâè÷ó (GMT). Íàïðèìåð, ïðè çàïóñêå íà ñèñòåìå, ãäå óñòàíîâëåíî Eastern Standard Time (GMT -0500), ïåðâàÿ ñòðîêà èç ñëåäóþùåãî ïðèìåðà âûâåäåò "Dec 31 1998 20:00:00", à âòîðàÿ - "Jan 01 1999 01:00:00". <example> <title>Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>gmstrftime</function></title> <programlisting role="php"> <![CDATA[ <?php setlocale(LC_TIME, 'en_US'); echo strftime("%b %d %Y %H:%M:%S", mktime(20, 0, 0, 12, 31, 98)) . "\n"; echo gmstrftime("%b %d %Y %H:%M:%S", mktime(20, 0, 0, 12, 31, 98)) . "\n"; ?> ]]> </programlisting> </example> </para> <para> Ñì. òàêæå îïèñàíèå ôóíêöèè <function>strftime</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/localtime.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/localtime.xml +++ phpdoc-ru/reference/datetime/functions/localtime.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.3 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.10 --> <refentry id="function.localtime"> <refnamediv> <refname>localtime</refname> <refpurpose>Âîçâðàùàåò ñèñòåìíîå âðåìÿ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>array</type><methodname>localtime</methodname> <methodparam choice="opt"><type>int</type><parameter> timestamp </parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter> is_associative </parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>localtime</function> âîçâðàùàåò ìàññèâ, àíàëîãè÷íûé ñòðóêòóðå, âîçâðàùàåìîé ñîîòâåòñòâóþùåé ôóíêöèåé C. Ïåðâûì àðãóìåíòîì ôóíêöèè <function>localtime</function> ÿâëÿåòñÿ ìåòêà âðåìåíè, åñëè ýòîò àðãóìåíò íå ïåðåäàí, èñïîëüçóåòñÿ òåêóùåå âðåìÿ, ïîëó÷åííîå âûçîâîì ôóíêöèè <function>time</function>. Åñëè àðãóìåíò <parameter>is_associative</parameter> íå ïåðåäàí èëè èëè ðàâåí 0, âîçâðà÷àåòñÿ ìàññèâ ñ ÷èñëîâûìè èíäåêñàìè. Åñëè ýòîò àðãóìåíò ðàâåí 1, ôóíêöèÿ <function>localtime</function> âîçâðàøàåò àññîöèàòèâíûé ìàññèâ, ñîäåðæàùèé êîìïîíåíòû ñòðóêòóðû, âîçâðàùàåìîé ôóíêöèåé C localtime. Ñïèñîê èíäåêñîâ : <itemizedlist> <listitem> <simpara> "tm_sec" - ñåêóíäû </simpara> </listitem> <listitem> <simpara> "tm_min" - ìèíóòû </simpara> </listitem> <listitem> <simpara> "tm_hour" - ÷àñû </simpara> </listitem> <listitem> <simpara> "tm_mday" - äåíü ìåñÿöà </simpara> </listitem> <listitem> <simpara> "tm_mon" - ìåñÿö ãîäà, 0 ñîîòâåòñòâóåò ÿíâàðþ </simpara> </listitem> <listitem> <simpara> "tm_year" - Êîëè÷åñòâî ëåò, ïðîøåäøèõ ñ 1900 ã. </simpara> </listitem> <listitem> <simpara> "tm_wday" - äåíü íåäåëè </simpara> </listitem> <listitem> <simpara> "tm_yday" - ïîðÿäêîâûé íîìåð äíÿ â ãîäó </simpara> </listitem> <listitem> <simpara> "tm_isdst" - ïðèçíàê ëåòíåãî âðåìåíè </simpara> </listitem> </itemizedlist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/microtime.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/microtime.xml +++ phpdoc-ru/reference/datetime/functions/microtime.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.9 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.microtime"> <refnamediv> <refname>microtime</refname> <refpurpose>Âîçâðàùàåò ìåòêó âðåìåíè ñ ìèêðîñåêóíäàìè</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>mixed</type><methodname>microtime</methodname> <methodparam choice="opt"><type>bool</type><parameter>get_as_float</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>microtime</function> âîçâðàùàåò òåêóùóþ ìåòêó âðåìåíè ñ ìèêðîñåêóíäàìè. Ýòà ôóíêöèÿ äîñòóïíà òîëüêî íà îïåðàöèîííûõ ñèñòåìàõ, â êîòîðûõ åñòü ñèñòåìíàÿ ôóíêöèÿ gettimeofday(). </para> <para> Ïðè âûçîâå áåç íåîáÿçàòåëüíîãî ïàðàìåòðà, âîçâðàùàåòñÿ ñòðîêà â ôîðìàòå "msec sec", ãäå sec - ýòî êîëè÷åñòâî ñåêóíä, ïðîøåäøèõ ñ íà÷àëà Ýðû Unix (1 ÿíâàðÿ 1970, 00:00:00 GMT), à msec - ýòî äðîáíàÿ ÷àñòü. </para> <para> Åñëè ïåðåäàí àðãóìåíò <parameter>get_as_float</parameter>, ðàâíûé &true;, ôóíêöèÿ <function>microtime</function> âîçâðàùàåò äåéñòâèòåëüíîå ÷èñëî. </para> <note> <simpara> Àðãóìåíò <parameter>get_as_float</parameter> ïîÿâèëñÿ â <literal>PHP 5.0.0</literal>. </simpara> </note> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>microtime</function></title> <programlisting role="php"> <![CDATA[ <?php function getmicrotime() { list($usec, $sec) = explode(" ", microtime()); return ((float)$usec + (float)$sec); } $time_start = getmicrotime(); for ($i=0; $i < 1000; $i++) { // Íè÷åãî íå äåëàòü. Ïîâòîðèòü 1000 ðàç } $time_end = getmicrotime(); $time = $time_end - $time_start; echo "Íè÷åãî íå äåëàë $time ñåêóíä\n"; // â PHP 5 òî æå ñàìîå ìîæíî ñäåëàòü âîò òàê: $time_start = microtime(1); for ($i=0; $i < 1000; $i++) { // Íè÷åãî íå äåëàòü. Ïîâòîðèòü 1000 ðàç } $time_end = microtime(1); $time = $time_end - $time_start; echo "Íè÷åãî íå äåëàë $time ñåêóíä\n"; ?> ]]> </programlisting> </example> </para> <para> Ñì. òàêæå îïèñàíèå ôóíêöèè <function>time</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/mktime.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/mktime.xml +++ phpdoc-ru/reference/datetime/functions/mktime.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.8 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.mktime"> <refnamediv> <refname>mktime</refname> <refpurpose>Âîçâðàùàåò ìåòêó âðåìåíè äëÿ çàäàííîé äàòû</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>mktime</methodname> <methodparam choice="opt"><type>int</type><parameter>hour</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>minute</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>second</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>month</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>day</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>is_dst</parameter></methodparam> </methodsynopsis> <para> <emphasis>Ïðåäåïðåæäåíèå:</emphasis> Îáðàòèòå âíèìàíèå íà ñòðàííûé ïîðÿäîê àðãóìåíòîâ, îòëè÷àþùèéñÿ îò ïîðÿäêà àðãóìåíòîâ ñòàíäàðòíîé ôóíêöèè Unix mktime() è äåëàþùèé íåóäîáíîé ðàáîòó ñ íåîáÿçàòåëüíûìè àðãóìåíòàìè. ×àñòî ïðè íàïèñàíèè ñêðèïòîâ ïóòàþò ïîðÿäîê àðãóìåíòîâ, ÷òî ïðèâîäèò ê îøèáêàì. </para> <para> Ôóíêöèÿ âîçâðàùàåò ìåòêó âðåìåíè Unix, ñîîòâåòñòâóþùóþ äàòå è âðåìåíè, çàäàííûì àðãóìåíòàìè. Ìåòêà âðåìåíè - ýòî öåëî ÷èñëî, ðàâíîå ðàçíèöå â ñåêóíäàõ ìåæäó çàäàííîé äàòîé/âðåìåíåì è íà÷àëîì Ýðû Unix (1 ÿíâàðÿ 1970 ã). </para> <para> Àðãóìåíòû ìîãóò áûòü îïóùåíû â ïîðÿäêå ñïðàâà íàëåâî. Îïóùåííûå àðãóìåíòû ñ÷èòàþòñÿ ðàâíûìè ñîîòâåòñòâóþùèì êîìïîíåíòàì ëîêàëüíîé äàòû/âðåìåíè. </para> <para> Àðãóìåíò <parameter>is_dst</parameter> ìîæåò áûòü óñòàíîâëåí â 1, åñëè çàäàííîé äàòå ñîîòâåòñòâóåò ëåòíåå âðåìÿ, 0 â ïðîòèâíîì ñëó÷àå, èëè -1 (çíà÷åíèå ïî óìîë÷àíèþ), åñëè íåèçâåñòíî, äåéñòâóåò ëè ëåòíååå âðåìÿ íà çàäàííóþ äàòó.  ïîñëåäíåì ñëó÷àå PHP ïûòàåòñÿ îïðåäåëèòü ýòî ñàìîñòîÿòåëüíî. Ýòî ìîæíî ïðèâåñòè ê íåîæèäàííîìó ðåçóëüòàòó (êîòîðûé, òåì íå ìåíåå, íå áóäåò íåâåðíûì). </para> <note> <para> Àðãóìåíò <parameter>is_dst</parameter> áûë äîáàâëåí â âåðñèè 3.0.10. </para> </note> <para> Ôóíêöèþ <function>mktime</function> óäîáíî èñïîëüçîâàòü äëÿ âûïîëíåíèÿ àðèôìåòè÷åñêèõ îïåðàöèé ñ äàòàìè, òàê êàê îíà âû÷èñëÿåò âåðíûå çíà÷åíèÿ ïðè íåêîððåêòíûõ àðãóìåíòàõ. Íàïðèìåð, â ñëåäóþùåì ïðèìåðå êàæäàÿ ñòðîêà âûâåäåò "Jan-01-1998". <example> <title>Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>mktime</function></title> <programlisting role="php"> <![CDATA[ <?php echo date("M-d-Y", mktime(0, 0, 0, 12, 32, 1997)); echo date("M-d-Y", mktime(0, 0, 0, 13, 1, 1997)); echo date("M-d-Y", mktime(0, 0, 0, 1, 1, 1998)); echo date("M-d-Y", mktime(0, 0, 0, 1, 1, 98)); ?> ]]> </programlisting> </example> <parameter>Year</parameter> ìîæåò áûòü äâóõ- èëè ÷åòûðåõçíà÷íûì ÷èñëîì. Çíà÷åíèÿ îò 0 äî 69 ñîîòâåòñòâóþò 2000-2069, à 70-99 ñîîòâåòñòâóþò 1970-1999 (â áîëüøèíñòâå ñîâðåìåííûõ ñèñòåì, ãäå âðåìÿ ïðåäñòàâëÿåòñÿ 32-áèòíûì öåëûì ñî çíàêîì, äîïóñòèìûìè ÿâëÿþòñÿ çíà÷åíèÿ <parameter>year</parameter> ìåæäó 1901 è 2038). </para> <para> <note> <title>Windows</title> <simpara> Íè îäíà èç âåðñèé Windows íå ïîääåðæèâàåò îòðèöàòåëüíûå ìåòêè âðåìåíè. Ïîýòîìó äëÿ Windows äîïóñòèìûìè ÿâëÿþòñÿ çíà÷åíèÿ <parameter>year</parameter> ìåæäó 1970 è 2038. </simpara> </note> </para> <para> Ïîñëåäíèé äåíü ëþáîãî ìåñÿöà ìîæíî âû÷èñëèòü êàê "íóëåâîé" äåíü ñëåäóþùåãî ìåñÿöà. Îáà ïðèâåäåííûõ íèæå ïðèìåðà âûâåäóò "Ïîñëåäíèé äåíü â ôåâðàëå 2000 ã: 29". <example> <title>Last day of next month</title> <programlisting role="php"> <![CDATA[ <?php $lastday = mktime(0, 0, 0, 3, 0, 2000); echo strftime("Ïîñëåäíèé äåíü â ôåâðàëå 2000 ã:: %d", $lastday); $lastday = mktime(0, 0, 0, 4, -31, 2000); echo strftime("Ïîñëåäíèé äåíü â ôåâðàëå 2000 ã:: %d", $lastday); ?> ]]> </programlisting> </example> </para> <simpara> Äàòû, â êîòîðûõ ãîä, ìåñÿö è äåíü ðàâíû 0, ñ÷èòàþòñÿ íåâåðíûìè (èíà÷å èì áû ñîîòâåòñòâîâàëà äàòà 30.11.1999, ÷òî, ñîãëàñèòåñü, áûëî áû äîâîëüíî ñòðàííî). </simpara> <para> Ñì. òàêæå îïèñàíèå ôóíêöèé <function>date</function> è <function>time</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/strftime.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/strftime.xml +++ phpdoc-ru/reference/datetime/functions/strftime.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.13 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.strftime"> <refnamediv> <refname>strftime</refname> <refpurpose>Ôîðìàòèðóåò òåêóùóþ äàòó/âðåìÿ ñ ó÷åòîì òåêóùåé ëîêàëè</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>string</type><methodname>strftime</methodname> <methodparam><type>string</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter> timestamp </parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò ñòðîêó, îòôîðìàòèðîâàííóþ â ñîîòâåòñòâèè ñ àðãóìåíòîì <parameter>format</parameter>, èñïîëüçóÿ àðãóìåíò <parameter>timestamp</parameter> èëè òåêóùåå ñèñòåìíîå âðåìÿ, åñëè ýòîò àðãóìåíò íå ïåðåäàí. Íàçâàíèÿ ìåñÿöåâ, äíåé íåäåëè è äðóãèå ñòðîêè, çàâèñÿùèå îò ÿçûêà, ñîîòâåòñòâóþò òåêóùåé ëîêàëè, óñòàíîâëåííîé ôóíêöèåé <function>setlocale</function>. </para> <para>  ôîðìàòèðóþùåé ñòðîêå ðàñïîçíàþòñÿ ñëåäóþùèå ñèìâîëû: <itemizedlist> <listitem> <simpara> %a - ñîêðàùåííîå íàçâàíèå äíÿ íåäåëè â òåêóùåé ëîêàëè </simpara> </listitem> <listitem> <simpara> %A - ïîëíîå íàçâàíèå äíÿ íåäåëè â òåêóùåé ëîêàëè </simpara> </listitem> <listitem> <simpara> %b - ñîêðàùåííîå íàçâàíèå ìåñÿöà íåäåëè â òåêóùåé ëîêàëè </simpara> </listitem> <listitem> <simpara> %B - ïîëíîå íàçâàíèå ìåñÿöà íåäåëè â òåêóùåé ëîêàëè </simpara> </listitem> <listitem> <simpara> %c - ïðåäïî÷òèòåëüíûé ôîðìàò äàòû è âðåìåíè â òåêóùåé ëîêàëè </simpara> </listitem> <listitem> <simpara> %C - ñòîëåòèå (ãîä, äåëåííûé íà 100 è îãðóãëåííûé äî öåëîãî, îò 00 äî 99) </simpara> </listitem> <listitem> <simpara> %d - äåíü ìåñÿöà â âèäå äåñÿòè÷íîãî ÷èñëà (îò 01 äî 31) </simpara> </listitem> <listitem> <simpara> %D - àíàëîãè÷íî %m/%d/%y </simpara> </listitem> <listitem> <simpara> %e - äåíü ìåñÿöà â âèäå äåñÿòè÷íîãî ÷èñëà, åñëè ýòî îäíà öèôðà, òî ïåðåä íåé äîáàâëÿåòñÿ ïðîáåë (îò ' 1' äî '31') </simpara> </listitem> <listitem> <simpara> %g - ïîäîáíî %G, íî áåç ñòîëåòèÿ. </simpara> </listitem> <listitem> <simpara> %G - Ãîä, 4-çíà÷íîå ÷èñëî, ñîîòâåòñòâóþùåå íîìåðó íåäåëè ïî ISO (ñì. %V). Àíàëîãè÷íî %Y, çà èñêëþ÷åíèåì òîãî, ÷òî åñëè íîìåð íåäåëè ïî ISO ñîîòâåòñòâóåò ïðåäûäóùåìó èëè ñëåäóþùåìó ãîäó, èñïîëüçóåòñÿ ñîîòâåòñòâóþùèé ãîä. </simpara> </listitem> <listitem> <simpara> %h - àíàëîãè÷íî %b </simpara> </listitem> <listitem> <simpara> %H - íîìåð ÷àñà îò 00 äî 23 </simpara> </listitem> <listitem> <simpara> %I - íîìåð ÷àñà îò 01 äî 12 </simpara> </listitem> <listitem> <simpara> %j - íîìåð äíÿ â ãîäó (îò 001 äî 366) </simpara> </listitem> <listitem> <simpara> %m - íîìåð ìåñÿöà (îò 01 äî 12) </simpara> </listitem> <listitem> <simpara> %M - ìèíóòû </simpara> </listitem> <listitem> <simpara> %n - ñèìâîë "\n" </simpara> </listitem> <listitem> <simpara> %p - `am' èëè `pm', èëè ñîîòâåòñòâóþùèå ñòðîêè â òåêóùåé ëîêàëè </simpara> </listitem> <listitem> <simpara> %r - âðåìÿ â ôîðìàòå a.m. èëè p.m. </simpara> </listitem> <listitem> <simpara> %R - âðåìÿ â 24-÷àñîâîì ôîðìàòå </simpara> </listitem> <listitem> <simpara> %S - ñåêóíäû </simpara> </listitem> <listitem> <simpara> %t - ñèìâîë òàáóëÿöèè ("\t") </simpara> </listitem> <listitem> <simpara> %T - òåêóùåå âðåìÿ, àíàëîãè÷íî %H:%M:%S </simpara> </listitem> <listitem> <simpara> %u - íîìåð äíÿ íåäåëè îò 1 äî 7, ãäå 1 ñîîòâåòñòâóåò ïîíåäåëüíèêó </simpara> <warning> <simpara> Íà Sun Solaris 1 ñîîòâåòñòâóåò âîñêðåñåíüþ, õîòÿ â ISO 9889:1999 (òåêóùèé ñòàíäàðò ÿçûêà C) ÿâíî óêàçàíî, ÷òî ýòî äîëæåí áûòü ïîíåäåëüíèê. </simpara> </warning> </listitem> <listitem> <simpara> %U - ïîðÿäêîâûé íîìåð íåäåëè â òåêóùåì ãîäó. Ïåðâûì äíåì ïåðâîé íåäåëè â ãîäó ñ÷èòàåòñÿ ïåðâîå âîñêðåñåíüå ãîäà. </simpara> </listitem> <listitem> <simpara> %V - Ïîðÿäêîâûé íîìåð íåäåëè â ãîäó ïî ñòàíäàðòó ISO 8601:1988 îò 01 äî 53, ãäå 1 ñîîòâåòñòâóåò ïåðâîé íåäåëå â ãîäó, â êîòîðîé êàê ìèíèìóì 4 äíÿ ïðèíàäëåæàò ýòîìó ãîäó. Ïåðâûì äíåì íåäåëè ñ÷èòàåòñÿ ïîíåäåëüíèê. (Èñïîëüçóéòå %G or %g äëÿ îïðåäåëåíèÿ ñîîòâåòñòâóþùåãî ãîäà) </simpara> </listitem> <listitem> <simpara> %W - ïîðÿäêîâûé íîìåð íåäåëè â òåêóùåì ãîäó. Ïåðâûì äíåì ïåðâîé íåäåëè â ãîäó ñ÷èòàåòñÿ ïåðâûé ïîíåäåëüíèê ãîäà. </simpara> </listitem> <listitem> <simpara> %w - íîìåð äíÿ íåäåëè, 0 ñîîòâåòñòâóåò âîñêðåñåíüþ </simpara> </listitem> <listitem> <simpara> %x - ïðåäïî÷òèòåëüíûé ôîðìàò äàòû áåç âðåìåíè â òåêóùåé ëîêàëè </simpara> </listitem> <listitem> <simpara> %X - ïðåäïî÷òèòåëüíûé ôîðìàò âðåìåíè áåç äàòû â òåêóùåé ëîêàëè </simpara> </listitem> <listitem> <simpara> %y - ãîä áåç ñòîëåòèÿ (îò 00 äî 99) </simpara> </listitem> <listitem> <simpara> %Y - ãîä, âêëþ÷àÿ ñòîëåòèå </simpara> </listitem> <listitem> <simpara> %Z - âðåìåííàÿ çîíà â âèäå ñìåùåíèÿ, àááðèâåàòóðû èëè ïîëíîãî íàèìåíîâàíèÿ </simpara> </listitem> <listitem> <simpara> %% - ñèìâîë `%' </simpara> </listitem> </itemizedlist> <note> <para> <function>strftime</function> èñïîëüçóåò ôóíêöèè îïåðàöèîííîé ñèñòåìû, ïîýòîìó îòäåëüíûå ôîðìàòèðóþùèå ñèìâîëû ìîãóò íå ðàáîòàòü â âàøåé îïåðàöèîííîé ñèñòåìå. Êðîìå òîãî, íå âñå ïëàòôîðìû ïîääåðæèâàþò îòðèöàòåëüíûå ìåòêè âðåìåíè support negative timestamps. Ýòî çíà÷èò, ÷òî %e, %T, %R è %D (à âîçìîæíî è äðóãèå) è äàòû äî <literal>Jan 1, 1970</literal> íå ïîääåðæèâàþòñÿ Windows, íåêîòîðûìè âåðñèÿìè Linux è íåêîòîðûìè äðóãèìè îïåðàöèîííûìè ñèñòåìàìè. Ñïèñîê ôîðìàòèðóþùèõ ñèìâîëîâ, ïîääåðæèâàåìûõ Windows, ìîæíî íàéòè íà <ulink url="&url.strftime.win32;">ñàéòå <acronym>MSDN</acronym></ulink>. </para> </note> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>strftime</function> ñ ðàçíûìè ëîêàëÿìè</title> <programlisting role="php"> <![CDATA[ <?php setlocale(LC_TIME, "C"); echo strftime("%A"); setlocale(LC_TIME, "fi_FI"); echo strftime(" ïî-ôèíñêè - %A,"); setlocale(LC_TIME, "fr_FR"); echo strftime(" ïî-ôðàíöóçñêè - %A è"); setlocale(LC_TIME, "de_DE"); echo strftime(" ïî-íåìåöêè - %A.\n"); ?> ]]> </programlisting> </example> Ýòîò ïðèìåð áóäåò ðàáîòàòü, åñëè íà âàøåé ñèñòåìå óñòàíîâëåíû ñîîòâåòñòâóþùèå ëîêàëè. <note> <simpara> %G and %V, êîòîðûå îñíîâàíû íà íîìåðå íåäåëè ïî ISO 8601:1988, Ìîãóò äàâàòü ðåçóëüòàò, îòëè÷íûé îò îæèäàåìîãî, åñëè âû íå ïîëíîñòüþ ïîíèìàåòå ñèñòåìó íóìåðàöèè, èñïîëüçóåìóþ ýòèì ñòàíäàðòîì. Ñìîòðèòå îïèñàíèå %V âûøå è ñëåäóþùèé ïðèìåð. </simpara> </note> <example> <title>Ïðèìåð íîìåðîâ íåäåëè ïî ISO 8601:1988</title> <programlisting role="php"> <![CDATA[ <?php /* Äåêàáðü 2002 / ßíâàðü 2003 ISO Ïí Âò Ñð ×ò Ïò Ñá Âñ ----- ---------------------------- 51 16 17 18 19 20 21 22 52 23 24 25 26 27 28 29 1 30 31 1 2 3 4 5 2 6 7 8 9 10 11 12 3 13 14 15 16 17 18 19 */ // Âûâîä: 12/28/2002 - %V,%G,%Y = 52,2002,2002 echo "12/28/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y", strtotime("12/28/2002")) . "\n"; // Âûâîä: 12/30/2002 - %V,%G,%Y = 1,2003,2002 echo "12/30/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y", strtotime("12/30/2002")) . "\n"; // Âûâîä: 1/3/2003 - %V,%G,%Y = 1,2003,2003 echo "1/3/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2003")) . "\n"; // Âûâîä: 1/10/2003 - %V,%G,%Y = 2,2003,2003 echo "1/10/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/10/2003")) . "\n"; /* Äåêàáðü 2004 / ßíâàðü 2005 ISO Ïí Âò Ñð ×ò Ïò Ñá Âñ ----- ---------------------------- 51 13 14 15 16 17 18 19 52 20 21 22 23 24 25 26 53 27 28 29 30 31 1 2 1 3 4 5 6 7 8 9 2 10 11 12 13 14 15 16 */ // Âûâîä: 12/23/2004 - %V,%G,%Y = 52,2004,2004 echo "12/23/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/23/2004")) . "\n"; // Âûâîä: 12/31/2004 - %V,%G,%Y = 53,2004,2004 echo "12/31/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/31/2004")) . "\n"; // Âûâîä: 1/2/2005 - %V,%G,%Y = 53,2004,2005 echo "1/2/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/2/2005")) . "\n"; // Âûâîä: 1/3/2005 - %V,%G,%Y = 1,2005,2005 echo "1/3/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2005")) . "\n"; ?> ]]> </programlisting> </example> </para> <para> Ñì. òàêæå îïèñàíèå ôóíêöèé <function>setlocale</function>, <function>mktime</function>, è <ulink url="&spec.strftime;"> ñïåöèôèêàöèþ <function>strftime</function> Open Group</ulink>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/strtotime.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/strtotime.xml +++ phpdoc-ru/reference/datetime/functions/strtotime.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.7 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.8 --> <refentry id="function.strtotime"> <refnamediv> <refname>strtotime</refname> <refpurpose>Ïðåîáðàçóåò òåêñòîâîå ïðåäñòàâëåíèå äàòû íà àíãëèéñêîì ÿçûêå â ìåòêó âðåìåíè Unix</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>int</type><methodname>strtotime</methodname> <methodparam><type>string</type><parameter>time</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>now</parameter></methodparam> </methodsynopsis> <simpara> Ïåðâûì ïàðàìåòðîì ôóíêöèè äîëæíà áûòü ñòðîêà ñ äàòîé íà àíãëèéñêîì ÿçûêå, êîòîðàÿ áóäåò ïðåîáðàçîâàíà â ìåòêó âðåìåíè îòíîñèòåëüíî ìåòêè âðåìåíè, ïåðåäàííîé â <parameter>now</parameter>, èëè òåêóùåãî âðåìåíè, åñëè àðãóìåíò <parameter>now</parameter> îïóùåí.  ñëó÷àå îøèáêè âîçâðàùàåòñÿ <literal>-1</literal>. </simpara> <simpara> Ôóíêöèÿ <function>strtotime</function> èñïîëüçóåò GNU ôîðìàò äàòû, ïîýòîìó ðåêîìåíäóåòñÿ îçíàêîìèòüñÿ ñ ðóêîâîäñòâîì GNU <ulink url="&url.gnu.man.date-input;">Date Input Formats</ulink>, ãäå îïèñûâàåòñÿ ñèíòàêñèñ àðãóìåíòà <parameter>time</parameter>. </simpara> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>strtotime</function></title> <programlisting role="php"> <![CDATA[ <?php echo strtotime("now"), "\n"; echo strtotime("10 September 2000"), "\n"; echo strtotime("+1 day"), "\n"; echo strtotime("+1 week"), "\n"; echo strtotime("+1 week 2 days 4 hours 2 seconds"), "\n"; echo strtotime("next Thursday"), "\n"; echo strtotime("last Monday"), "\n"; ?> ]]> </programlisting> </example> </para> <para> <example> <title>Ïðîâåðêà îøèáîê</title> <programlisting role="php"> <![CDATA[ <?php $str = 'Not Good'; if (($timestamp = strtotime($str)) === -1) { echo "Ñòðîêà ($str) íåäîïóñòèìà"; } else { echo "$str == " . date('l dS of F Y h:i:s A', $timestamp); } ?> ]]> </programlisting> </example> </para> <note> <para> Äëÿ áîëüøèíñòâà ñèñòåì äîïóñòèìûìè ÿâëÿþòñÿ äàòû ñ 13 äåêàáðÿ 1901, 20:45:54 GMT ïî 19 ÿíâàðÿ 2038, 03:14:07 GMT. (Ýòè äàòû ñîîòâåòñòâóþò ìèíèìàëüíîìó è ìàêñèìàëüíîìó çíà÷åíèþ 32-áèòîâîãî öåëîãî ñî çíàêîì). Äëÿ Windows äîïóñòèìû äàòû ñ 01-01-1970 ïî 19-01-2038. Íå âñå ïëàòôîðìû ïîääåðæèâàþò îòðèöàòåëüíûå ìåòêè âðåìåíè, ïîýòîìó äàòû ðàíåå 1 ÿíâàðÿ 1970 ã. íå ïîääåðæèâàþòñÿ â Windows, íåêîòîðûõ âåðñèÿõ Linux è íåêîòîðûõ äðóãèõ îïåðàöèîííûõ ñèñòåìàõ. </para> </note> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/time.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/time.xml +++ phpdoc-ru/reference/datetime/functions/time.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.4 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.time"> <refnamediv> <refname>time</refname> <refpurpose>Âîçâðàùàåò òåêóùóþ ìåòêó âðåìåíè</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>int</type><methodname>time</methodname> <void/> </methodsynopsis> <para> Âîçâðàùàåò êîëè÷åñòâî ñåêóíä, ïðîøåäøèõ ñ íà÷àëà Ýïîõè Unix (The Unix Epoch, 1 ÿíâàðÿ 1970, 00:00:00 GMT) äî òåêóùåãî âðåìåíè. </para> <para> Ñì. òàêæå îïèñàíèå ôóíêöèé <function>date</function> è <function>microtime</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/reference.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/reference.xml +++ phpdoc-ru/reference/datetime/reference.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.6 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <reference id="ref.datetime"> <title>Ôóíêöèè äëÿ ðàáîòû ñ äàòîé è âðåìåíåì</title> <titleabbrev>Äàòà è âðåìÿ</titleabbrev> <partintro> <section id="datetime.intro"> &reftitle.intro; <para> Ýòè ôóíêöèè ïîçâîëÿþò ïîëó÷èòü äàòó è âðåìÿ íà ñåðâåðå, ãäå âûïîëíÿåòñÿ PHP ñêðèïò. Èñïîëüçóÿ ýòè ôóíêöèè, äàòó è âðåìÿ ìîæíî ïðåäñòàâèòü â ðàçëè÷íûõ ôîðìàòàõ. </para> <note> <simpara> Îáðàòèòå âíèìàíèå, ÷òî ðàáîòà ýòèõ ôóíêöèé çàâèñèò îò òåêóùåé ëîêàëè íà ñåðâåðå. Òàêæå ñëåäóåò ïðèíèìàòü âî âíèìàíèå ëåòíåå âðåìÿ è âèñîêîñíûå ãîäû. </simpara> </note> </section> <section id="datetime.required"> &reftitle.required; &no.requirement; </section> <section id="datetime.installation"> &reftitle.install; &no.install; </section> <section id="datetime.runtime"> &reftitle.runtime; &no.config; </section> <section id="datetime.resources"> &reftitle.resources; &no.resource; </section> <section id="datetime.constants"> &reftitle.constants; &no.constants; </section> </partintro> &reference.datetime.functions; </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/checkdate.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/checkdate.xml +++ phpdoc-ru/reference/datetime/functions/checkdate.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.checkdate"> <refnamediv> <refname>checkdate</refname> <refpurpose>Ïðîâåðÿåò ïðàâèëüíîñòü äàòû ïî ãðåãîðèàíñêîìó êàëåíäàðþ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>bool</type><methodname>checkdate</methodname> <methodparam><type>int</type><parameter>month</parameter></methodparam> <methodparam><type>int</type><parameter>day</parameter></methodparam> <methodparam><type>int</type><parameter>year</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò &true; åñëè äàòà, çàäàííàÿ àðãóìåíòàìè, ÿâëÿåòñÿ ïðàâèëüíîé; èíà÷å âîçâðàùàåò &false;. Äàòà ñ÷èòàåòñÿ ïðàâèëüíîé, åñëè: <itemizedlist> <listitem> <simpara> ãîä â äèàïàçîíå îò 1 äî 32767 âêëþ÷èòåëüíî </simpara> </listitem> <listitem> <simpara> ìåñÿö â äèàïàçîíå îò 1 äî 12 âêëþ÷èòåëüíî </simpara> </listitem> <listitem> <simpara> <parameter>day</parameter> ÿâëÿåòñÿ äîïóñòèìûì íîìåðîì äíÿ äëÿ ìåñÿöà, çàäàííîãî àðãóìåíòîì <parameter>month</parameter>, ïðèíèìàÿ âî âíèìàíèå,÷òî <parameter>year</parameter> ìîæåò çàäàâàòü âèñîêîñíûé ãîä. </simpara> </listitem> </itemizedlist> </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>checkdate</function></title> <programlisting role="php"> <![CDATA[ <?php var_dump(checkdate(12, 31, 2000)); var_dump(checkdate(2, 29, 2001)); ?> ]]> </programlisting> <para> Ïðèâåäåííûé âûøå ïðèìåð âûâåäåò: </para> <screen> <![CDATA[ bool(true) bool(false) ]]> </screen> </example> </para> <para> Ñì.òàêæå îïèñàíèå ôóíêöèé <function>mktime</function> è <function>strtotime</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/date.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/date.xml +++ phpdoc-ru/reference/datetime/functions/date.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.15 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.date"> <refnamediv> <refname>date</refname> <refpurpose>Ôîðìàòèðóåò ñèñòåìíóþ äàòó/âðåìÿ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>string</type><methodname>date</methodname> <methodparam><type>string</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter> timestamp </parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò âðåìÿ, îòôîðìàòèðîâàííîå â ñîîòâåòñòâèè ñ àðãóìåíòîì <parameter>format</parameter>, èñïîëüçóÿ ìåòêó âðåìåíè, çàäàííóþ àðãóìåíòîì <parameter>timestamp</parameter> èëè òåêóùåå ñèñòåìíîå âðåìÿ, åñëè <parameter>timestamp</parameter> íå çàäàí. Äðóãèìè ñëîâàìè, <parameter>timestamp</parameter> ÿâëÿåòñÿ íåîáÿçàòåëüíûì è ïî óìîë÷àíèþ ðàâåí çíà÷åíèþ, âîçâðàùàåìîìó ôóíêöèåé <function>time</function>. <note> <para> Äëÿ áîëüøèíñòâà ñèñòåì äîïóñòèìûìè ÿâëÿþòñÿ äàòû ñ 13 äåêàáðÿ 1901, 20:45:54 GMT ïî 19 ÿíâàðÿ 2038, 03:14:07 GMT. (Ýòè äàòû ñîîòâåòñòâóþò ìèíèìàëüíîìó è ìàêñèìàëüíîìó çíà÷åíèþ 32-áèòîâîãî öåëîãî ñî çíàêîì). Äëÿ Windows äîïóñòèìû äàòû ñ 01-01-1970 ïî 19-01-2038. </para> </note> <note> <para> Äëÿ ïîëó÷åíèÿ ìåòêè âðåìåíè èç ñòðîêîâîãî ïðåäñòàâëåíèÿ äàòû ìîæíî èñïîëüçîâàòü ôóíêöèþ <function>strtotime</function>. Êðîìå òîãî, íåêîòîðûå áàçû äàííûõ èìåþò ñîáñòâåííûå ôóíêöèè äëÿ ïðåîáðàçîâàíèÿ âíóòðåííåãî ïðåäñòàâëåíèÿ äàòû â ìåòêó âðåìåíè (íàïðìåð, ôóíêöèÿ MySQL <ulink url="&url.mysql.docs.date;">UNIX_TIMESTAMP</ulink>). </para> </note> </para> <para> <table> <title> ïàðàìåòðå <parameter>format</parameter> ðàñïîçíàþòñÿ ñëåäóþùèå ñèìâîëû </title> <tgroup cols="3"> <thead> <row> <entry>Ñèìâîë â ñòðîêå <parameter>format</parameter></entry> <entry>Îïèñàíèå</entry> <entry>Ïðèìåð âîçâðàùàåìîãî çíà÷åíèÿ</entry> </row> </thead> <tbody> <row> <entry><literal>a</literal></entry> <entry>Ante meridiem èëè Post meridiem â íèæíåì ðåãèñòðå</entry> <entry><literal>am</literal> èëè <literal>pm</literal></entry> </row> <row> <entry><literal>A</literal></entry> <entry>Ante meridiem èëè Post meridiem â âåðõíåì ðåãèñòðå</entry> <entry><literal>AM</literal> èëè <literal>PM</literal></entry> </row> <row> <entry><literal>B</literal></entry> <entry>Âðåìÿ â ñòàäàðòå Swatch Internet</entry> <entry>Îò <literal>000</literal> äî <literal>999</literal></entry> </row> <row> <entry><literal>c</literal></entry> <entry>Äàòà â ôîðìàòå ISO 8601 (äîáàâëåíî â PHP 5)</entry> <entry>2004-02-12T15:19:21+00:00</entry> </row> <row> <entry><literal>d</literal></entry> <entry>Äåíü ìåñÿöà, 2 öèôðû ñ âåäóùèìè íóëÿìè</entry> <entry>îò <literal>01</literal> äî <literal>31</literal></entry> </row> <row> <entry><literal>D</literal></entry> <entry>Ñîêðàùåííîå íàèìåíîâàíèå äíÿ íåäåëè, 3 ñèìâîëà</entry> <entry>îò <literal>Mon</literal> äî <literal>Sun</literal></entry> </row> <row> <entry><literal>F</literal></entry> <entry>Ïîëíîå íàèìåíîâàíèå ìåñÿöà, íàïðèìåð January èëè March</entry> <entry>îò <literal>January</literal> äî <literal>December</literal></entry> </row> <row> <entry><literal>g</literal></entry> <entry>×àñû â 12-÷àñîâîì ôîðìàòå áåç âåäóùèõ íóëåé</entry> <entry>Îò <literal>1</literal> äî <literal>12</literal></entry> </row> <row> <entry><literal>G</literal></entry> <entry>×àñû â 24-÷àñîâîì ôîðìàòå áåç âåäóùèõ íóëåé</entry> <entry>Îò <literal>0</literal> äî <literal>23</literal></entry> </row> <row> <entry><literal>h</literal></entry> <entry>×àñû â 12-÷àñîâîì ôîðìàòå ñ âåäóùèìè íóëÿìè</entry> <entry>Îò <literal>01</literal> äî <literal>12</literal></entry> </row> <row> <entry><literal>H</literal></entry> <entry>×àñû â 24-÷àñîâîì ôîðìàòå ñ âåäóùèìè íóëÿìè</entry> <entry>Îò <literal>00</literal> äî <literal>23</literal></entry> </row> <row> <entry><literal>i</literal></entry> <entry>Ìèíóòû ñ âåäóùèìè íóëÿìè</entry> <entry><literal>00</literal> to <literal>59</literal></entry> </row> <row> <entry><literal>I</literal> (çàãëàâíàÿ i)</entry> <entry>Ïðèçíàê ëåòíåãî âðåìåíè</entry> <entry><literal>1</literal>, åñëè äàòà ñîîòâåòñòâóåò ëåòíåìó âðåìåíè, èíà÷å <literal>0</literal> otherwise.</entry> </row> <row> <entry><literal>j</literal></entry> <entry>Äåíü ìåñÿöà áåç âåäóùèõ íóëåé</entry> <entry>Îò <literal>1</literal> äî <literal>31</literal></entry> </row> <row> <entry><literal>l</literal> (ñòðî÷íàÿ 'L')</entry> <entry>Ïîëíîå íàèìåíîâàíèå äíÿ íåäåëè</entry> <entry>Îò <literal>Sunday</literal> äî <literal>Saturday</literal></entry> </row> <row> <entry><literal>L</literal></entry> <entry>Ïðèçíàê âèñîêîñíîãî ãîäà</entry> <entry><literal>1</literal>, åñëè ãîä âèñîêîñíûé, èíà÷å <literal>0</literal>.</entry> </row> <row> <entry><literal>m</literal></entry> <entry>Ïîðÿäêîâûé íîìåð ìåñÿöà ñ âåäóùèìè íóëÿìè</entry> <entry>Îò <literal>01</literal> äî <literal>12</literal></entry> </row> <row> <entry><literal>M</literal></entry> <entry>Ñîêðàùåííîå íàèìåíîâàíèå ìåñÿöà, 3 ñèìâîëà</entry> <entry>Îò <literal>Jan</literal> äî <literal>Dec</literal></entry> </row> <row> <entry><literal>n</literal></entry> <entry>Ïîðÿäêîâûé íîìåð ìåñÿöà áåç âåäóùèõ íóëåé</entry> <entry>Îò <literal>1</literal> äî <literal>12</literal></entry> </row> <row> <entry><literal>O</literal></entry> <entry>Ðàçíèöà ñ âðåìåíåì ïî Ãðèíâè÷ó â ÷àñàõ</entry> <entry>Íàïðèìåð: <literal>+0200</literal></entry> </row> <row> <entry><literal>r</literal></entry> <entry>Äàòà â ôîðìàòå <ulink url="&url.rfc;2822">RFC 2822</ulink></entry> <entry>Íàïðèìåð: <literal>Thu, 21 Dec 2000 16:01:07 +0200</literal></entry> </row> <row> <entry><literal>s</literal></entry> <entry>Ñåêóíäû ñ âåäóùèìè íóëÿìè</entry> <entry>Îò <literal>00</literal> äî <literal>59</literal></entry> </row> <row> <entry><literal>S</literal></entry> <entry>Àíãëèéñêèé ñóôôèêñ ïîðÿäêîâîãî ÷èñëèòåëüíîãî äíÿ ìåñÿöà, 2 ñèìâîëà</entry> <entry> <literal>st</literal>, <literal>nd</literal>, <literal>rd</literal> èëè <literal>th</literal>. Ïðèìåíÿåòñÿ ñîâìåñòíî ñ <literal>j</literal> </entry> </row> <row> <entry><literal>t</literal></entry> <entry>Êîëè÷åñòâî äíåé â ìåñÿöå</entry> <entry>Îò <literal>28</literal> äî <literal>31</literal></entry> </row> <row> <entry><literal>T</literal></entry> <entry>Âðåìåííàÿ çîíà íà ñåðâåðå</entry> <entry>Ïðèìåðû: <literal>EST</literal>, <literal>MDT</literal> ...</entry> </row> <row> <entry><literal>U</literal></entry> <entry>Êîëè÷åñòâî ñåêóíä, ïðîøåäøèõ ñ íà÷àëà Ýðû Unix (1 ÿíâàðÿ 1970, 00:00:00 GMT)</entry> <entry>Ñì. òàêæå <function>time</function></entry> </row> <row> <entry><literal>w</literal></entry> <entry>Ïîðÿäêîâûé íîìåð äíÿ íåäåëè</entry> <entry>Îò <literal>0</literal> (âîñêðåñåíüå) äî <literal>6</literal> (ñóááîòà)</entry> </row> <row> <entry><literal>W</literal></entry> <entry>Ïîðÿäêîâûé íîìåð íåäåëè ãîäà ïî ISO-8601, ïåðâûé äåíü íåäåëè - ïîíåäåëüíèê (äîáàâëåíî â PHP 4.1.0)</entry> <entry>Íàïðèìåð: <literal>42</literal> (42-ÿ íåäåëÿ ãîäà)</entry> </row> <row> <entry><literal>Y</literal></entry> <entry>Ïîðÿäêîâûé íîìåð ãîäà, 4 öèôðû</entry> <entry>Ïðèìåðû: <literal>1999</literal>, <literal>2003</literal></entry> </row> <row> <entry><literal>y</literal></entry> <entry>Íîìåð ãîäà, 2 öèôðû</entry> <entry>Ïðèìåðû: <literal>99</literal>, <literal>03</literal></entry> </row> <row> <entry><literal>z</literal></entry> <entry>Ïîðÿäêîâûé íîìåð äíÿ â ãîäó (íóìåðàöèÿ ñ 0)</entry> <entry>Îò <literal>0</literal> äî <literal>365</literal></entry> </row> <row> <entry><literal>Z</literal></entry> <entry>Ñìåùåíèå âðåìåííîé çîíû â ñåêóíäàõ. Äëÿ âðåìåííûõ çîí çàïàäíåå UTC ýòî îòðèöàòåëüíîå ÷èñëî, âîñòî÷íåå UTC - ïîëîæèòåëüíîå.</entry> <entry>Îò <literal>-43200</literal> äî <literal>43200</literal></entry> </row> </tbody> </tgroup> </table> </para> <para> Ëþáûå äðóãèå ñèìâîëû, âñòðå÷åííûå â ñòðîêå <parameter>format</parameter>, áóäóò âûâåäåíû â ðåçóëüòèðóþùóþ ñòðîêó áåç èçìåíåíèé. <literal>Z</literal> âñåãäà âîçâðàùàåò <literal>0</literal> ïðè èñïîëüçîâàíèè <function>gmdate</function>. </para> <para> <example> <title>Ïðèìåðû èñïîëüçîâàíèÿ ôóíêöèè <function>date</function></title> <programlisting role="php"> <![CDATA[ <?php // âûâîä äíÿ íåäåëè, íàïðèìåð Wednesday echo date("l"); // âûâîä äàòû â ôîðìàòå: Wednesday 15th of January 2003 05:51:38 AM echo date("l dS of F Y h:i:s A"); // âûâîä: July 1, 2000 is on a Saturday echo "July 1, 2000 is on a " . date("l", mktime(0, 0, 0, 7, 1, 2000)); ?> ]]> </programlisting> </example> </para> <para> Èçáåæàòü ðàñïîçíàâàíèÿ ñèìâîëà êàê ôîðìàòèðóþùåãî ìîæíî, åñëè ýêðàíèðîâàòü ýòîò ñèìâîë ñ ïîìîùüþ <literal>\</literal> Åñëè â ñî÷åòàíèè ñ <literal>\</literal> ñèìâîë ÿâëÿååñÿ ñïåöèàëüíûì (íàïðèìåð, <literal>\t</literal>), ñëåäóåò äîáàâëÿòü åùå îäèí <literal>\</literal>. <example> <title>Ýêðàíèðîâàíèå ñèìâîëîâ â ôóíêöèè <function>date</function></title> <programlisting role="php"> <![CDATA[ <?php // âûâîä: Wednesday the 15th echo date("l \\t\h\e jS"); ?> ]]> </programlisting> </example> </para> <para> Ôóíêöèè <function>date</function> è <function>mktime</function> äëÿ âûâîäà ïðîøåäøèõ è áóäóùèõ äàò. <example> <title> <function>date</function> è <function>mktime</function> example </title> <programlisting role="php"> <![CDATA[ <?php $tomorrow = mktime(0, 0, 0, date("m") , date("d")+1, date("Y")); $lastmonth = mktime(0, 0, 0, date("m")-1, date("d"), date("Y")); $nextyear = mktime(0, 0, 0, date("m"), date("d"), date("Y")+1); ?> ]]> </programlisting> </example> <note> <para> Ëó÷øå âû÷èòàòü èëè ïðèáàâëÿòü êîëè÷åñòâî ñåêóíä â äíå èëè ìåñÿöå ê ê ìåòêå âðåìåíè, òàê êàê ïðèýòîì áóäåò ó÷òåí ïåðåõîä íà ëåòíåå âðåìÿ. </para> </note> </para> <para> Ïðèâåäåì åùå íåñêîëüêî ïðèìåðîâ èñïîëüçîâàíèÿ ôóíêöèè <function>date</function>. Ïîìíèòå, ÷òî ñëåäóåò ýêðàíèðîâàòü âñå ñèìâîëû, êîòîðûå âû õîòèòå âèäåòü â ðåçóëüòàòå ðàáîòû ôóíêöèè áåç èçìåíåíèé. Ýòî îòíîñèòñÿ è ê ñèìâîëàì, êîòîðûå â òåêóùåé âåðñèè PHP íå ðàñïîçíàþòñÿ êàê ñïåöèàëüíûå, òàê êàê ýòèì ñèìâîëàì ìîæåò áûòü íàçíà÷åíî çíà÷åíèå â ñëåäóþùèõ âåðñèÿõ. Èñïîëüçóéòå îäèíàðíûå êàâû÷êè äëÿ ïðåäîòâðàùåíèÿ ïðåîáðàçîâàíèÿ \n â ïåðåâîä ñòðîêè. <example> <title> Ôîðìàòèðîâàíèå ñ èñïîëüçîâàíèåì <function>date</function> </title> <programlisting role="php"> <![CDATA[ <?php // Ïðåäïîëîæèì, ÷òî òåêóùàÿ äàòà March 10th, 2001, 5:16:18 pm $today = date("F j, Y, g:i a"); // March 10, 2001, 5:16 pm $today = date("m.d.y"); // 03.10.01 $today = date("j, n, Y"); // 10, 3, 2001 $today = date("Ymd"); // 20010310 $today = date('h-i-s, j-m-y, it is w Day z '); // 05-16-17, 10-03-01, 1631 1618 6 Fripm01 $today = date('\i\t \i\s \t\h\e jS \d\a\y.'); // It is the 10th day. $today = date("D M j G:i:s T Y"); // Sat Mar 10 15:16:08 MST 2001 $today = date('H:m:s \m \i\s\ \m\o\n\t\h'); // 17:03:17 m is month $today = date("H:i:s"); // 17:16:17 ?> ]]> </programlisting> </example> </para> <para> Äëÿ ôîðìàòèðîâàíèÿ äàò íà äðóãèõ ÿçûêàõ èñïîëüçóéòå ôóíêöèè <function>setlocale</function> è <function>strftime</function>. </para> <para> Ñì. òàêæå îïèñàíèå ôóíêöèé <function>getlastmod</function>, <function>gmdate</function>, <function>mktime</function>, <function>strftime</function> è <function>time</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/getdate.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/getdate.xml +++ phpdoc-ru/reference/datetime/functions/getdate.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.8 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.getdate"> <refnamediv> <refname>getdate</refname> <refpurpose>Âîçâðàùàåò èíôîðìàöèþ î äàòå/âðåìåíè</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>array</type><methodname>getdate</methodname> <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò àññîöèàòèâíûé ìàññèâ, ñîäåðæàùèé èíôîðìàöèþ î äàòå, ïðåäñòàâëåííîé ìåòêîé âðåìåíè <parameter>timestamp</parameter> èëè òåêóùåì ñèñòåìíîì âðåìåíè, åñëè <parameter>timestamp</parameter> íå ïåðåäàí. Ìàññèâ ñîäåðæèò ñëåäóþùèå ýëåìåíòû: </para> <para> <table> <title>Èíäåêñû âîçâðàùàåìîãî àññîöèàòèâíîãî ìàññèâà</title> <tgroup cols="3"> <thead> <row> <entry>Èíäåêñ</entry> <entry>Îïèñàíèå</entry> <entry>Ïðèìåð çíà÷åíèÿ</entry> </row> </thead> <tbody> <row> <entry><literal>"seconds"</literal></entry> <entry>Ñåêóíäû</entry> <entry>Îò <literal>0</literal> äî <literal>59</literal></entry> </row> <row> <entry><literal>"minutes"</literal></entry> <entry>Ìèíóòû</entry> <entry>Îò <literal>0</literal> äî <literal>59</literal></entry> </row> <row> <entry><literal>"hours"</literal></entry> <entry>×àñû</entry> <entry>Îò <literal>0</literal> äî <literal>23</literal></entry> </row> <row> <entry><literal>"mday"</literal></entry> <entry>Ïîðÿäêîâûé íîìåð äíÿ ìåñÿöà</entry> <entry>Îò <literal>1</literal> äî <literal>31</literal></entry> </row> <row> <entry><literal>"wday"</literal></entry> <entry>Ïîðÿäêîâûé íîìåð äíÿ </entry> <entry>Îò <literal>0</literal> (âîñêðåñåíüå) äî <literal>6</literal> (ñóááîòà)</entry> </row> <row> <entry><literal>"mon"</literal></entry> <entry>Ïîðÿäêîâûé íîìåð ìåñÿöà</entry> <entry>Îò <literal>1</literal> äî <literal>12</literal></entry> </row> <row> <entry><literal>"year"</literal></entry> <entry>Ïîðÿäêîâûé íîìåð ãîäà, 4 öèôðû</entry> <entry>Ïðèìåðû: <literal>1999</literal>, <literal>2003</literal></entry> </row> <row> <entry><literal>"yday"</literal></entry> <entry>Ïîðÿäêîâûé íîìåð äíÿ â ãîäó (íóìåðàöèÿ ñ 0)</entry> <entry>Îò <literal>0</literal> äî <literal>366</literal></entry> </row> <row> <entry><literal>"weekday"</literal></entry> <entry>Ïîëíîå íàèìåíîâàíèå äíÿ íåäåëè</entry> <entry>Îò <literal>Sunday</literal> äî <literal>Saturday</literal></entry> </row> <row> <entry><literal>"month"</literal></entry> <entry>Ïîëíîå íàèìåíîâàíèå ìåñÿöà, íàïðèìåð January èëè March</entry> <entry>îò <literal>January</literal> äî <literal>December</literal></entry> </row> <row> <entry><literal>0</literal></entry> <entry>Êîëè÷åñêòâî ñåêóíä, ïðîøåäøèõ ñ íà÷àëà Ýðû Unix, ïîäîáíî çíà÷åíèþ, âîçâðàùàåìîìó ôóíêöèåé <function>time</function> è èñïîëüçóåìîìó ôóíêöèåé <function>date</function>.</entry> <entry>Ïëàòôîðìî-çàâèñèìîå, â áîëüøèíñòâå ñëó÷àåâ îò <literal>-2147483648</literal> äî <literal>2147483647</literal>. </entry> </row> </tbody> </tgroup> </table> </para> <para> <example> <title> Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>getdate</function> </title> <programlisting role="php"> <![CDATA[ <?php $today = getdate(); print_r($today); ?> ]]> </programlisting> <para> Âûâîä áóäåò âûãëÿäåòü òàê: </para> <screen> <![CDATA[ Array ( [seconds] => 40 [minutes] => 58 [hours] => 21 [mday] => 17 [wday] => 2 [mon] => 6 [year] => 2003 [yday] => 167 [weekday] => Tuesday [month] => June [0] => 1055901520 ) ]]> </screen> </example> </para> <para> See also <function>date</function>, <function>time</function>, and <function>setlocale</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/gettimeofday.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/gettimeofday.xml +++ phpdoc-ru/reference/datetime/functions/gettimeofday.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.3 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.gettimeofday"> <refnamediv> <refname>gettimeofday</refname> <refpurpose>Âîçâðàùàåò òåêóùåå âðåìÿ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>array</type><methodname>gettimeofday</methodname> <void/> </methodsynopsis> <para> Ýòà ôóíêöèÿ ÿâëÿåòñÿ èíòåðôåéñîì ê ñèñòåìíîìó âûçîâó gettimeofday(2). Îíà âîçâðàùàåò àññîöèàòèâíûé ìàññèâ, ñîäåðæàùèé èíôîðìàöèþ, ïîëó÷åííóþ îò ñèñòåìíîé ôóíêöèè. <itemizedlist> <listitem> <simpara> "sec" - ñåêóíäû </simpara> </listitem> <listitem> <simpara> "usec" - ìèêðîñåêóíäû </simpara> </listitem> <listitem> <simpara> "minuteswest" - ñìåùåíèå ê çàïàäó îò Ãðèíâè÷à, â ìèíóòàõ </simpara> </listitem> <listitem> <simpara> "dsttime" - òèï êîððåêöèè ëåòíåãî âðåìåíè </simpara> </listitem> </itemizedlist> </para> <para> <example> <title> Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>gettimeofday</function> </title> <programlisting role="php"> <![CDATA[ <?php print_r(gettimeofday()); ?> ]]> </programlisting> <para> Âûâîä áóäåò âûãëÿäåòü òàê: </para> <screen> <![CDATA[ Array ( [sec] => 1073504408 [usec] => 238215 [minuteswest] => 0 [dsttime] => 1 ) ]]> </screen> </example> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/gmdate.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/gmdate.xml +++ phpdoc-ru/reference/datetime/functions/gmdate.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.8 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.gmdate"> <refnamediv> <refname>gmdate</refname> <refpurpose>Ôîðìàòèðóåò äàòó/âðåìÿ ïî Ãðèíâè÷ó</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>string</type><methodname>gmdate</methodname> <methodparam><type>string</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam> </methodsynopsis> <para> Ýòà ôóíêöèÿ èäåíòè÷íà ôóíêöèè <function>date</function> çà èñêëþ÷åíèåì òîãî, ÷òî âîçâðàùàåò âðåìÿ ïî Ãðèíâè÷ó (GMT). Íàïðèìåð, â Ôèíëÿíäèè (GMT +0200), ïåðâàÿ ñòðîêà â ñëåäóþùåì ïðèìåðå âûâåäåò "Jan 01 1998 00:00:00", à âòîðàÿ - "Dec 31 1997 22:00:00". <example> <title><function>gmdate</function> example</title> <programlisting role="php"> <![CDATA[ <?php echo date("M d Y H:i:s", mktime(0, 0, 0, 1, 1, 1998)); echo gmdate("M d Y H:i:s", mktime(0, 0, 0, 1, 1, 1998)); ?> ]]> </programlisting> </example> </para> <note> <para>  ñåìåéñòâå ÎÑ Microsoft Windows ñèñòåìíûå áèáëèîòåêè, ðåàëèçóþùèå ýòó ôóíêöèþ, ñîäåðæàò îøèáêè, ïîýòîìó ôóíêöèÿ <function>gmdate</function> íà ýòèõ ñèñòåìàõ íå ïîääåðæèâàåò îòðèöàòåëüíûå çíà÷åíèÿ àðãóìåíòà <parameter>timestamp</parameter>. Äëÿ áîëåå ïîäðîáíîé èíôîðìàöèè, ñì. ñîîáùåíèÿ îá îøèáêàõ: <ulink url="&url.php.bugs;22620">#22620</ulink>, <ulink url="&url.php.bugs;22457">#22457</ulink>, è <ulink url="&url.php.bugs;14391">#14391</ulink>. </para> <para>  îïåðàöèîííûõ ñèñòåìàõ Unix/Linux ýòà ïðîáëåìà íå âîçíèêàåò, òàê êàê ñèñòåìíûå áèáëèîòåêè â ýòèõ ñèñòåìàõ ðåàëèçîâàíû êîððåêòíî. </para> <para> PHP íå ìîæåò èñïðàâèòü îøèáêè â ñèñòåìíûõ áèáëèîòåêàõ. Äëÿ ðåøåíèÿ ýòîé è ïîäîáíûõ ïðîáëåì îáðàùàéòåñü ê ïðîèçâîäèòåëþ îïåðàöèîííîé ñèñòåìû. </para> </note> <para> Ñì. òàêæå îïèñàíèå ôóíêöèé <function>date</function>, <function>mktime</function>, <function>gmmktime</function> è <function>strftime</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/gmmktime.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/gmmktime.xml +++ phpdoc-ru/reference/datetime/functions/gmmktime.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.4 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.gmmktime"> <refnamediv> <refname>gmmktime</refname> <refpurpose>Âîçâðàùàåò ìåòêó âðåìåíè Unix äëÿ âðåìåíè ïî Ãðèíâè÷ó</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>gmmktime</methodname> <methodparam choice="opt"><type>int</type><parameter>hour</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>minute</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>second</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>month</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>day</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>is_dst</parameter></methodparam> </methodsynopsis> <para> Ýòà ôóíêöèÿ èäåíòè÷íà ôóíêöèè <function>mktime</function>, çà èñêëþ÷åíèåì òîãî, ÷òî àðãóìåíòû ôîðìèðóþò âðåìÿ ïî Ãðèíâè÷ó (GMT). </para> <para> Ïîäîáíî ôóíêöèè <function>mktime</function>, àðãóìåíòû ìîãóò áûòü îïóùåíû â ïîðÿäêå ñïðàâà íàëåâî , â ýòîì ñëó÷àå îíè ïðåäïîëàãàþòñÿ ðàâíûìè ñîîòâåòñòâóþùèì êîìïîíåíòàì òåêóùåãî âðåìåíè ïî Ãðèíâè÷ó. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/gmstrftime.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/gmstrftime.xml +++ phpdoc-ru/reference/datetime/functions/gmstrftime.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.7 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.gmstrftime"> <refnamediv> <refname>gmstrftime</refname> <refpurpose>Ôîðìàòèðóåò äàòó/âðåìÿ ïî Ãðèíâè÷ó ñ ó÷åòîì òåêóùåé ëîêàëè</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>string</type><methodname>gmstrftime</methodname> <methodparam><type>string</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam> </methodsynopsis> <para> Ýòà ôóíêöèÿ èäåíòè÷íà ôóíêöèè <function>strftime</function> çà èñêëþ÷åíèåì òîãî, ÷òî âîçâðàùàåò âðåìÿ ïî Ãðèíâè÷ó (GMT). Íàïðèìåð, ïðè çàïóñêå íà ñèñòåìå, ãäå óñòàíîâëåíî Eastern Standard Time (GMT -0500), ïåðâàÿ ñòðîêà èç ñëåäóþùåãî ïðèìåðà âûâåäåò "Dec 31 1998 20:00:00", à âòîðàÿ - "Jan 01 1999 01:00:00". <example> <title>Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>gmstrftime</function></title> <programlisting role="php"> <![CDATA[ <?php setlocale(LC_TIME, 'en_US'); echo strftime("%b %d %Y %H:%M:%S", mktime(20, 0, 0, 12, 31, 98)) . "\n"; echo gmstrftime("%b %d %Y %H:%M:%S", mktime(20, 0, 0, 12, 31, 98)) . "\n"; ?> ]]> </programlisting> </example> </para> <para> Ñì. òàêæå îïèñàíèå ôóíêöèè <function>strftime</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/localtime.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/localtime.xml +++ phpdoc-ru/reference/datetime/functions/localtime.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.3 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.10 --> <refentry id="function.localtime"> <refnamediv> <refname>localtime</refname> <refpurpose>Âîçâðàùàåò ñèñòåìíîå âðåìÿ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>array</type><methodname>localtime</methodname> <methodparam choice="opt"><type>int</type><parameter> timestamp </parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter> is_associative </parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>localtime</function> âîçâðàùàåò ìàññèâ, àíàëîãè÷íûé ñòðóêòóðå, âîçâðàùàåìîé ñîîòâåòñòâóþùåé ôóíêöèåé C. Ïåðâûì àðãóìåíòîì ôóíêöèè <function>localtime</function> ÿâëÿåòñÿ ìåòêà âðåìåíè, åñëè ýòîò àðãóìåíò íå ïåðåäàí, èñïîëüçóåòñÿ òåêóùåå âðåìÿ, ïîëó÷åííîå âûçîâîì ôóíêöèè <function>time</function>. Åñëè àðãóìåíò <parameter>is_associative</parameter> íå ïåðåäàí èëè èëè ðàâåí 0, âîçâðà÷àåòñÿ ìàññèâ ñ ÷èñëîâûìè èíäåêñàìè. Åñëè ýòîò àðãóìåíò ðàâåí 1, ôóíêöèÿ <function>localtime</function> âîçâðàøàåò àññîöèàòèâíûé ìàññèâ, ñîäåðæàùèé êîìïîíåíòû ñòðóêòóðû, âîçâðàùàåìîé ôóíêöèåé C localtime. Ñïèñîê èíäåêñîâ : <itemizedlist> <listitem> <simpara> "tm_sec" - ñåêóíäû </simpara> </listitem> <listitem> <simpara> "tm_min" - ìèíóòû </simpara> </listitem> <listitem> <simpara> "tm_hour" - ÷àñû </simpara> </listitem> <listitem> <simpara> "tm_mday" - äåíü ìåñÿöà </simpara> </listitem> <listitem> <simpara> "tm_mon" - ìåñÿö ãîäà, 0 ñîîòâåòñòâóåò ÿíâàðþ </simpara> </listitem> <listitem> <simpara> "tm_year" - Êîëè÷åñòâî ëåò, ïðîøåäøèõ ñ 1900 ã. </simpara> </listitem> <listitem> <simpara> "tm_wday" - äåíü íåäåëè </simpara> </listitem> <listitem> <simpara> "tm_yday" - ïîðÿäêîâûé íîìåð äíÿ â ãîäó </simpara> </listitem> <listitem> <simpara> "tm_isdst" - ïðèçíàê ëåòíåãî âðåìåíè </simpara> </listitem> </itemizedlist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/microtime.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/microtime.xml +++ phpdoc-ru/reference/datetime/functions/microtime.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.9 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.microtime"> <refnamediv> <refname>microtime</refname> <refpurpose>Âîçâðàùàåò ìåòêó âðåìåíè ñ ìèêðîñåêóíäàìè</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>mixed</type><methodname>microtime</methodname> <methodparam choice="opt"><type>bool</type><parameter>get_as_float</parameter></methodparam> </methodsynopsis> <para> Ôóíêöèÿ <function>microtime</function> âîçâðàùàåò òåêóùóþ ìåòêó âðåìåíè ñ ìèêðîñåêóíäàìè. Ýòà ôóíêöèÿ äîñòóïíà òîëüêî íà îïåðàöèîííûõ ñèñòåìàõ, â êîòîðûõ åñòü ñèñòåìíàÿ ôóíêöèÿ gettimeofday(). </para> <para> Ïðè âûçîâå áåç íåîáÿçàòåëüíîãî ïàðàìåòðà, âîçâðàùàåòñÿ ñòðîêà â ôîðìàòå "msec sec", ãäå sec - ýòî êîëè÷åñòâî ñåêóíä, ïðîøåäøèõ ñ íà÷àëà Ýðû Unix (1 ÿíâàðÿ 1970, 00:00:00 GMT), à msec - ýòî äðîáíàÿ ÷àñòü. </para> <para> Åñëè ïåðåäàí àðãóìåíò <parameter>get_as_float</parameter>, ðàâíûé &true;, ôóíêöèÿ <function>microtime</function> âîçâðàùàåò äåéñòâèòåëüíîå ÷èñëî. </para> <note> <simpara> Àðãóìåíò <parameter>get_as_float</parameter> ïîÿâèëñÿ â <literal>PHP 5.0.0</literal>. </simpara> </note> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>microtime</function></title> <programlisting role="php"> <![CDATA[ <?php function getmicrotime() { list($usec, $sec) = explode(" ", microtime()); return ((float)$usec + (float)$sec); } $time_start = getmicrotime(); for ($i=0; $i < 1000; $i++) { // Íè÷åãî íå äåëàòü. Ïîâòîðèòü 1000 ðàç } $time_end = getmicrotime(); $time = $time_end - $time_start; echo "Íè÷åãî íå äåëàë $time ñåêóíä\n"; // â PHP 5 òî æå ñàìîå ìîæíî ñäåëàòü âîò òàê: $time_start = microtime(1); for ($i=0; $i < 1000; $i++) { // Íè÷åãî íå äåëàòü. Ïîâòîðèòü 1000 ðàç } $time_end = microtime(1); $time = $time_end - $time_start; echo "Íè÷åãî íå äåëàë $time ñåêóíä\n"; ?> ]]> </programlisting> </example> </para> <para> Ñì. òàêæå îïèñàíèå ôóíêöèè <function>time</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/mktime.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/mktime.xml +++ phpdoc-ru/reference/datetime/functions/mktime.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.8 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.mktime"> <refnamediv> <refname>mktime</refname> <refpurpose>Âîçâðàùàåò ìåòêó âðåìåíè äëÿ çàäàííîé äàòû</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>mktime</methodname> <methodparam choice="opt"><type>int</type><parameter>hour</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>minute</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>second</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>month</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>day</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>is_dst</parameter></methodparam> </methodsynopsis> <para> <emphasis>Ïðåäåïðåæäåíèå:</emphasis> Îáðàòèòå âíèìàíèå íà ñòðàííûé ïîðÿäîê àðãóìåíòîâ, îòëè÷àþùèéñÿ îò ïîðÿäêà àðãóìåíòîâ ñòàíäàðòíîé ôóíêöèè Unix mktime() è äåëàþùèé íåóäîáíîé ðàáîòó ñ íåîáÿçàòåëüíûìè àðãóìåíòàìè. ×àñòî ïðè íàïèñàíèè ñêðèïòîâ ïóòàþò ïîðÿäîê àðãóìåíòîâ, ÷òî ïðèâîäèò ê îøèáêàì. </para> <para> Ôóíêöèÿ âîçâðàùàåò ìåòêó âðåìåíè Unix, ñîîòâåòñòâóþùóþ äàòå è âðåìåíè, çàäàííûì àðãóìåíòàìè. Ìåòêà âðåìåíè - ýòî öåëî ÷èñëî, ðàâíîå ðàçíèöå â ñåêóíäàõ ìåæäó çàäàííîé äàòîé/âðåìåíåì è íà÷àëîì Ýðû Unix (1 ÿíâàðÿ 1970 ã). </para> <para> Àðãóìåíòû ìîãóò áûòü îïóùåíû â ïîðÿäêå ñïðàâà íàëåâî. Îïóùåííûå àðãóìåíòû ñ÷èòàþòñÿ ðàâíûìè ñîîòâåòñòâóþùèì êîìïîíåíòàì ëîêàëüíîé äàòû/âðåìåíè. </para> <para> Àðãóìåíò <parameter>is_dst</parameter> ìîæåò áûòü óñòàíîâëåí â 1, åñëè çàäàííîé äàòå ñîîòâåòñòâóåò ëåòíåå âðåìÿ, 0 â ïðîòèâíîì ñëó÷àå, èëè -1 (çíà÷åíèå ïî óìîë÷àíèþ), åñëè íåèçâåñòíî, äåéñòâóåò ëè ëåòíååå âðåìÿ íà çàäàííóþ äàòó.  ïîñëåäíåì ñëó÷àå PHP ïûòàåòñÿ îïðåäåëèòü ýòî ñàìîñòîÿòåëüíî. Ýòî ìîæíî ïðèâåñòè ê íåîæèäàííîìó ðåçóëüòàòó (êîòîðûé, òåì íå ìåíåå, íå áóäåò íåâåðíûì). </para> <note> <para> Àðãóìåíò <parameter>is_dst</parameter> áûë äîáàâëåí â âåðñèè 3.0.10. </para> </note> <para> Ôóíêöèþ <function>mktime</function> óäîáíî èñïîëüçîâàòü äëÿ âûïîëíåíèÿ àðèôìåòè÷åñêèõ îïåðàöèé ñ äàòàìè, òàê êàê îíà âû÷èñëÿåò âåðíûå çíà÷åíèÿ ïðè íåêîððåêòíûõ àðãóìåíòàõ. Íàïðèìåð, â ñëåäóþùåì ïðèìåðå êàæäàÿ ñòðîêà âûâåäåò "Jan-01-1998". <example> <title>Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>mktime</function></title> <programlisting role="php"> <![CDATA[ <?php echo date("M-d-Y", mktime(0, 0, 0, 12, 32, 1997)); echo date("M-d-Y", mktime(0, 0, 0, 13, 1, 1997)); echo date("M-d-Y", mktime(0, 0, 0, 1, 1, 1998)); echo date("M-d-Y", mktime(0, 0, 0, 1, 1, 98)); ?> ]]> </programlisting> </example> <parameter>Year</parameter> ìîæåò áûòü äâóõ- èëè ÷åòûðåõçíà÷íûì ÷èñëîì. Çíà÷åíèÿ îò 0 äî 69 ñîîòâåòñòâóþò 2000-2069, à 70-99 ñîîòâåòñòâóþò 1970-1999 (â áîëüøèíñòâå ñîâðåìåííûõ ñèñòåì, ãäå âðåìÿ ïðåäñòàâëÿåòñÿ 32-áèòíûì öåëûì ñî çíàêîì, äîïóñòèìûìè ÿâëÿþòñÿ çíà÷åíèÿ <parameter>year</parameter> ìåæäó 1901 è 2038). </para> <para> <note> <title>Windows</title> <simpara> Íè îäíà èç âåðñèé Windows íå ïîääåðæèâàåò îòðèöàòåëüíûå ìåòêè âðåìåíè. Ïîýòîìó äëÿ Windows äîïóñòèìûìè ÿâëÿþòñÿ çíà÷åíèÿ <parameter>year</parameter> ìåæäó 1970 è 2038. </simpara> </note> </para> <para> Ïîñëåäíèé äåíü ëþáîãî ìåñÿöà ìîæíî âû÷èñëèòü êàê "íóëåâîé" äåíü ñëåäóþùåãî ìåñÿöà. Îáà ïðèâåäåííûõ íèæå ïðèìåðà âûâåäóò "Ïîñëåäíèé äåíü â ôåâðàëå 2000 ã: 29". <example> <title>Last day of next month</title> <programlisting role="php"> <![CDATA[ <?php $lastday = mktime(0, 0, 0, 3, 0, 2000); echo strftime("Ïîñëåäíèé äåíü â ôåâðàëå 2000 ã:: %d", $lastday); $lastday = mktime(0, 0, 0, 4, -31, 2000); echo strftime("Ïîñëåäíèé äåíü â ôåâðàëå 2000 ã:: %d", $lastday); ?> ]]> </programlisting> </example> </para> <simpara> Äàòû, â êîòîðûõ ãîä, ìåñÿö è äåíü ðàâíû 0, ñ÷èòàþòñÿ íåâåðíûìè (èíà÷å èì áû ñîîòâåòñòâîâàëà äàòà 30.11.1999, ÷òî, ñîãëàñèòåñü, áûëî áû äîâîëüíî ñòðàííî). </simpara> <para> Ñì. òàêæå îïèñàíèå ôóíêöèé <function>date</function> è <function>time</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/strftime.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/strftime.xml +++ phpdoc-ru/reference/datetime/functions/strftime.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.13 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.strftime"> <refnamediv> <refname>strftime</refname> <refpurpose>Ôîðìàòèðóåò òåêóùóþ äàòó/âðåìÿ ñ ó÷åòîì òåêóùåé ëîêàëè</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>string</type><methodname>strftime</methodname> <methodparam><type>string</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter> timestamp </parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò ñòðîêó, îòôîðìàòèðîâàííóþ â ñîîòâåòñòâèè ñ àðãóìåíòîì <parameter>format</parameter>, èñïîëüçóÿ àðãóìåíò <parameter>timestamp</parameter> èëè òåêóùåå ñèñòåìíîå âðåìÿ, åñëè ýòîò àðãóìåíò íå ïåðåäàí. Íàçâàíèÿ ìåñÿöåâ, äíåé íåäåëè è äðóãèå ñòðîêè, çàâèñÿùèå îò ÿçûêà, ñîîòâåòñòâóþò òåêóùåé ëîêàëè, óñòàíîâëåííîé ôóíêöèåé <function>setlocale</function>. </para> <para>  ôîðìàòèðóþùåé ñòðîêå ðàñïîçíàþòñÿ ñëåäóþùèå ñèìâîëû: <itemizedlist> <listitem> <simpara> %a - ñîêðàùåííîå íàçâàíèå äíÿ íåäåëè â òåêóùåé ëîêàëè </simpara> </listitem> <listitem> <simpara> %A - ïîëíîå íàçâàíèå äíÿ íåäåëè â òåêóùåé ëîêàëè </simpara> </listitem> <listitem> <simpara> %b - ñîêðàùåííîå íàçâàíèå ìåñÿöà íåäåëè â òåêóùåé ëîêàëè </simpara> </listitem> <listitem> <simpara> %B - ïîëíîå íàçâàíèå ìåñÿöà íåäåëè â òåêóùåé ëîêàëè </simpara> </listitem> <listitem> <simpara> %c - ïðåäïî÷òèòåëüíûé ôîðìàò äàòû è âðåìåíè â òåêóùåé ëîêàëè </simpara> </listitem> <listitem> <simpara> %C - ñòîëåòèå (ãîä, äåëåííûé íà 100 è îãðóãëåííûé äî öåëîãî, îò 00 äî 99) </simpara> </listitem> <listitem> <simpara> %d - äåíü ìåñÿöà â âèäå äåñÿòè÷íîãî ÷èñëà (îò 01 äî 31) </simpara> </listitem> <listitem> <simpara> %D - àíàëîãè÷íî %m/%d/%y </simpara> </listitem> <listitem> <simpara> %e - äåíü ìåñÿöà â âèäå äåñÿòè÷íîãî ÷èñëà, åñëè ýòî îäíà öèôðà, òî ïåðåä íåé äîáàâëÿåòñÿ ïðîáåë (îò ' 1' äî '31') </simpara> </listitem> <listitem> <simpara> %g - ïîäîáíî %G, íî áåç ñòîëåòèÿ. </simpara> </listitem> <listitem> <simpara> %G - Ãîä, 4-çíà÷íîå ÷èñëî, ñîîòâåòñòâóþùåå íîìåðó íåäåëè ïî ISO (ñì. %V). Àíàëîãè÷íî %Y, çà èñêëþ÷åíèåì òîãî, ÷òî åñëè íîìåð íåäåëè ïî ISO ñîîòâåòñòâóåò ïðåäûäóùåìó èëè ñëåäóþùåìó ãîäó, èñïîëüçóåòñÿ ñîîòâåòñòâóþùèé ãîä. </simpara> </listitem> <listitem> <simpara> %h - àíàëîãè÷íî %b </simpara> </listitem> <listitem> <simpara> %H - íîìåð ÷àñà îò 00 äî 23 </simpara> </listitem> <listitem> <simpara> %I - íîìåð ÷àñà îò 01 äî 12 </simpara> </listitem> <listitem> <simpara> %j - íîìåð äíÿ â ãîäó (îò 001 äî 366) </simpara> </listitem> <listitem> <simpara> %m - íîìåð ìåñÿöà (îò 01 äî 12) </simpara> </listitem> <listitem> <simpara> %M - ìèíóòû </simpara> </listitem> <listitem> <simpara> %n - ñèìâîë "\n" </simpara> </listitem> <listitem> <simpara> %p - `am' èëè `pm', èëè ñîîòâåòñòâóþùèå ñòðîêè â òåêóùåé ëîêàëè </simpara> </listitem> <listitem> <simpara> %r - âðåìÿ â ôîðìàòå a.m. èëè p.m. </simpara> </listitem> <listitem> <simpara> %R - âðåìÿ â 24-÷àñîâîì ôîðìàòå </simpara> </listitem> <listitem> <simpara> %S - ñåêóíäû </simpara> </listitem> <listitem> <simpara> %t - ñèìâîë òàáóëÿöèè ("\t") </simpara> </listitem> <listitem> <simpara> %T - òåêóùåå âðåìÿ, àíàëîãè÷íî %H:%M:%S </simpara> </listitem> <listitem> <simpara> %u - íîìåð äíÿ íåäåëè îò 1 äî 7, ãäå 1 ñîîòâåòñòâóåò ïîíåäåëüíèêó </simpara> <warning> <simpara> Íà Sun Solaris 1 ñîîòâåòñòâóåò âîñêðåñåíüþ, õîòÿ â ISO 9889:1999 (òåêóùèé ñòàíäàðò ÿçûêà C) ÿâíî óêàçàíî, ÷òî ýòî äîëæåí áûòü ïîíåäåëüíèê. </simpara> </warning> </listitem> <listitem> <simpara> %U - ïîðÿäêîâûé íîìåð íåäåëè â òåêóùåì ãîäó. Ïåðâûì äíåì ïåðâîé íåäåëè â ãîäó ñ÷èòàåòñÿ ïåðâîå âîñêðåñåíüå ãîäà. </simpara> </listitem> <listitem> <simpara> %V - Ïîðÿäêîâûé íîìåð íåäåëè â ãîäó ïî ñòàíäàðòó ISO 8601:1988 îò 01 äî 53, ãäå 1 ñîîòâåòñòâóåò ïåðâîé íåäåëå â ãîäó, â êîòîðîé êàê ìèíèìóì 4 äíÿ ïðèíàäëåæàò ýòîìó ãîäó. Ïåðâûì äíåì íåäåëè ñ÷èòàåòñÿ ïîíåäåëüíèê. (Èñïîëüçóéòå %G or %g äëÿ îïðåäåëåíèÿ ñîîòâåòñòâóþùåãî ãîäà) </simpara> </listitem> <listitem> <simpara> %W - ïîðÿäêîâûé íîìåð íåäåëè â òåêóùåì ãîäó. Ïåðâûì äíåì ïåðâîé íåäåëè â ãîäó ñ÷èòàåòñÿ ïåðâûé ïîíåäåëüíèê ãîäà. </simpara> </listitem> <listitem> <simpara> %w - íîìåð äíÿ íåäåëè, 0 ñîîòâåòñòâóåò âîñêðåñåíüþ </simpara> </listitem> <listitem> <simpara> %x - ïðåäïî÷òèòåëüíûé ôîðìàò äàòû áåç âðåìåíè â òåêóùåé ëîêàëè </simpara> </listitem> <listitem> <simpara> %X - ïðåäïî÷òèòåëüíûé ôîðìàò âðåìåíè áåç äàòû â òåêóùåé ëîêàëè </simpara> </listitem> <listitem> <simpara> %y - ãîä áåç ñòîëåòèÿ (îò 00 äî 99) </simpara> </listitem> <listitem> <simpara> %Y - ãîä, âêëþ÷àÿ ñòîëåòèå </simpara> </listitem> <listitem> <simpara> %Z - âðåìåííàÿ çîíà â âèäå ñìåùåíèÿ, àááðèâåàòóðû èëè ïîëíîãî íàèìåíîâàíèÿ </simpara> </listitem> <listitem> <simpara> %% - ñèìâîë `%' </simpara> </listitem> </itemizedlist> <note> <para> <function>strftime</function> èñïîëüçóåò ôóíêöèè îïåðàöèîííîé ñèñòåìû, ïîýòîìó îòäåëüíûå ôîðìàòèðóþùèå ñèìâîëû ìîãóò íå ðàáîòàòü â âàøåé îïåðàöèîííîé ñèñòåìå. Êðîìå òîãî, íå âñå ïëàòôîðìû ïîääåðæèâàþò îòðèöàòåëüíûå ìåòêè âðåìåíè support negative timestamps. Ýòî çíà÷èò, ÷òî %e, %T, %R è %D (à âîçìîæíî è äðóãèå) è äàòû äî <literal>Jan 1, 1970</literal> íå ïîääåðæèâàþòñÿ Windows, íåêîòîðûìè âåðñèÿìè Linux è íåêîòîðûìè äðóãèìè îïåðàöèîííûìè ñèñòåìàìè. Ñïèñîê ôîðìàòèðóþùèõ ñèìâîëîâ, ïîääåðæèâàåìûõ Windows, ìîæíî íàéòè íà <ulink url="&url.strftime.win32;">ñàéòå <acronym>MSDN</acronym></ulink>. </para> </note> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>strftime</function> ñ ðàçíûìè ëîêàëÿìè</title> <programlisting role="php"> <![CDATA[ <?php setlocale(LC_TIME, "C"); echo strftime("%A"); setlocale(LC_TIME, "fi_FI"); echo strftime(" ïî-ôèíñêè - %A,"); setlocale(LC_TIME, "fr_FR"); echo strftime(" ïî-ôðàíöóçñêè - %A è"); setlocale(LC_TIME, "de_DE"); echo strftime(" ïî-íåìåöêè - %A.\n"); ?> ]]> </programlisting> </example> Ýòîò ïðèìåð áóäåò ðàáîòàòü, åñëè íà âàøåé ñèñòåìå óñòàíîâëåíû ñîîòâåòñòâóþùèå ëîêàëè. <note> <simpara> %G and %V, êîòîðûå îñíîâàíû íà íîìåðå íåäåëè ïî ISO 8601:1988, Ìîãóò äàâàòü ðåçóëüòàò, îòëè÷íûé îò îæèäàåìîãî, åñëè âû íå ïîëíîñòüþ ïîíèìàåòå ñèñòåìó íóìåðàöèè, èñïîëüçóåìóþ ýòèì ñòàíäàðòîì. Ñìîòðèòå îïèñàíèå %V âûøå è ñëåäóþùèé ïðèìåð. </simpara> </note> <example> <title>Ïðèìåð íîìåðîâ íåäåëè ïî ISO 8601:1988</title> <programlisting role="php"> <![CDATA[ <?php /* Äåêàáðü 2002 / ßíâàðü 2003 ISO Ïí Âò Ñð ×ò Ïò Ñá Âñ ----- ---------------------------- 51 16 17 18 19 20 21 22 52 23 24 25 26 27 28 29 1 30 31 1 2 3 4 5 2 6 7 8 9 10 11 12 3 13 14 15 16 17 18 19 */ // Âûâîä: 12/28/2002 - %V,%G,%Y = 52,2002,2002 echo "12/28/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y", strtotime("12/28/2002")) . "\n"; // Âûâîä: 12/30/2002 - %V,%G,%Y = 1,2003,2002 echo "12/30/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y", strtotime("12/30/2002")) . "\n"; // Âûâîä: 1/3/2003 - %V,%G,%Y = 1,2003,2003 echo "1/3/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2003")) . "\n"; // Âûâîä: 1/10/2003 - %V,%G,%Y = 2,2003,2003 echo "1/10/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/10/2003")) . "\n"; /* Äåêàáðü 2004 / ßíâàðü 2005 ISO Ïí Âò Ñð ×ò Ïò Ñá Âñ ----- ---------------------------- 51 13 14 15 16 17 18 19 52 20 21 22 23 24 25 26 53 27 28 29 30 31 1 2 1 3 4 5 6 7 8 9 2 10 11 12 13 14 15 16 */ // Âûâîä: 12/23/2004 - %V,%G,%Y = 52,2004,2004 echo "12/23/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/23/2004")) . "\n"; // Âûâîä: 12/31/2004 - %V,%G,%Y = 53,2004,2004 echo "12/31/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/31/2004")) . "\n"; // Âûâîä: 1/2/2005 - %V,%G,%Y = 53,2004,2005 echo "1/2/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/2/2005")) . "\n"; // Âûâîä: 1/3/2005 - %V,%G,%Y = 1,2005,2005 echo "1/3/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2005")) . "\n"; ?> ]]> </programlisting> </example> </para> <para> Ñì. òàêæå îïèñàíèå ôóíêöèé <function>setlocale</function>, <function>mktime</function>, è <ulink url="&spec.strftime;"> ñïåöèôèêàöèþ <function>strftime</function> Open Group</ulink>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/strtotime.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/strtotime.xml +++ phpdoc-ru/reference/datetime/functions/strtotime.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.7 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.8 --> <refentry id="function.strtotime"> <refnamediv> <refname>strtotime</refname> <refpurpose>Ïðåîáðàçóåò òåêñòîâîå ïðåäñòàâëåíèå äàòû íà àíãëèéñêîì ÿçûêå â ìåòêó âðåìåíè Unix</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>int</type><methodname>strtotime</methodname> <methodparam><type>string</type><parameter>time</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>now</parameter></methodparam> </methodsynopsis> <simpara> Ïåðâûì ïàðàìåòðîì ôóíêöèè äîëæíà áûòü ñòðîêà ñ äàòîé íà àíãëèéñêîì ÿçûêå, êîòîðàÿ áóäåò ïðåîáðàçîâàíà â ìåòêó âðåìåíè îòíîñèòåëüíî ìåòêè âðåìåíè, ïåðåäàííîé â <parameter>now</parameter>, èëè òåêóùåãî âðåìåíè, åñëè àðãóìåíò <parameter>now</parameter> îïóùåí.  ñëó÷àå îøèáêè âîçâðàùàåòñÿ <literal>-1</literal>. </simpara> <simpara> Ôóíêöèÿ <function>strtotime</function> èñïîëüçóåò GNU ôîðìàò äàòû, ïîýòîìó ðåêîìåíäóåòñÿ îçíàêîìèòüñÿ ñ ðóêîâîäñòâîì GNU <ulink url="&url.gnu.man.date-input;">Date Input Formats</ulink>, ãäå îïèñûâàåòñÿ ñèíòàêñèñ àðãóìåíòà <parameter>time</parameter>. </simpara> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèè <function>strtotime</function></title> <programlisting role="php"> <![CDATA[ <?php echo strtotime("now"), "\n"; echo strtotime("10 September 2000"), "\n"; echo strtotime("+1 day"), "\n"; echo strtotime("+1 week"), "\n"; echo strtotime("+1 week 2 days 4 hours 2 seconds"), "\n"; echo strtotime("next Thursday"), "\n"; echo strtotime("last Monday"), "\n"; ?> ]]> </programlisting> </example> </para> <para> <example> <title>Ïðîâåðêà îøèáîê</title> <programlisting role="php"> <![CDATA[ <?php $str = 'Not Good'; if (($timestamp = strtotime($str)) === -1) { echo "Ñòðîêà ($str) íåäîïóñòèìà"; } else { echo "$str == " . date('l dS of F Y h:i:s A', $timestamp); } ?> ]]> </programlisting> </example> </para> <note> <para> Äëÿ áîëüøèíñòâà ñèñòåì äîïóñòèìûìè ÿâëÿþòñÿ äàòû ñ 13 äåêàáðÿ 1901, 20:45:54 GMT ïî 19 ÿíâàðÿ 2038, 03:14:07 GMT. (Ýòè äàòû ñîîòâåòñòâóþò ìèíèìàëüíîìó è ìàêñèìàëüíîìó çíà÷åíèþ 32-áèòîâîãî öåëîãî ñî çíàêîì). Äëÿ Windows äîïóñòèìû äàòû ñ 01-01-1970 ïî 19-01-2038. Íå âñå ïëàòôîðìû ïîääåðæèâàþò îòðèöàòåëüíûå ìåòêè âðåìåíè, ïîýòîìó äàòû ðàíåå 1 ÿíâàðÿ 1970 ã. íå ïîääåðæèâàþòñÿ â Windows, íåêîòîðûõ âåðñèÿõ Linux è íåêîòîðûõ äðóãèõ îïåðàöèîííûõ ñèñòåìàõ. </para> </note> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/datetime/functions/time.xml?r=1.1&p=1 Index: phpdoc-ru/reference/datetime/functions/time.xml +++ phpdoc-ru/reference/datetime/functions/time.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.4 Maintainer: blindman Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.time"> <refnamediv> <refname>time</refname> <refpurpose>Âîçâðàùàåò òåêóùóþ ìåòêó âðåìåíè</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>int</type><methodname>time</methodname> <void/> </methodsynopsis> <para> Âîçâðàùàåò êîëè÷åñòâî ñåêóíä, ïðîøåäøèõ ñ íà÷àëà Ýïîõè Unix (The Unix Epoch, 1 ÿíâàðÿ 1970, 00:00:00 GMT) äî òåêóùåãî âðåìåíè. </para> <para> Ñì. òàêæå îïèñàíèå ôóíêöèé <function>date</function> è <function>microtime</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->