cvs: phpdoc-cs /reference/bzip2 configure.xml reference.xml /reference/bzip2/functions bzopen.xml /reference/datetime reference.xml
/reference/datetime/functions checkdate.xml date.xml getdate.xml gmdate.xml gmmktime.xml gmstrftime.xml localtime.xml microtime.xml mktime.xml
strftime.xml
| From: | Jakub Vrana | Date: | Mon, 08 Dec 2003 15:12:59 +0000 |
| Subject: | cvs: phpdoc-cs /reference/bzip2 configure.xml reference.xml /reference/bzip2/functions bzopen.xml /reference/datetime reference.xml /reference/datetime/functions checkdate.xml date.xml getdate.xml gmdate.xml gmmktime.xml gmstrftime.xml localtime.xml microtime.xml mktime.xml strftime.xml |
||
| Groups: | php.doc.cs | ||
| Request: | Send a blank email to doc-cs+get-87@lists.php.net to get a copy of this message | ||
vrana Mon Dec 8 10:12:59 2003 EDT
Added files:
/phpdoc-cs/reference/bzip2 configure.xml
Modified files:
/phpdoc-cs/reference/bzip2 reference.xml
/phpdoc-cs/reference/bzip2/functions bzopen.xml
/phpdoc-cs/reference/datetime reference.xml
/phpdoc-cs/reference/datetime/functions checkdate.xml date.xml
getdate.xml gmdate.xml
gmmktime.xml gmstrftime.xml
localtime.xml microtime.xml
mktime.xml strftime.xml
Log:
Make up to date
Index: phpdoc-cs/reference/bzip2/reference.xml diff -u phpdoc-cs/reference/bzip2/reference.xml:1.1 phpdoc-cs/reference/bzip2/reference.xml:1.2 --- phpdoc-cs/reference/bzip2/reference.xml:1.1 Fri Jun 21 17:42:31 2002 +++ phpdoc-cs/reference/bzip2/reference.xml Mon Dec 8 10:12:54 2003 @@ -19,18 +19,11 @@ <para> Tento modul pou¾ívá funkce z knihovny <ulink url="&url.bzip2;">bzip2</ulink> od Juliana Sewarda. + Tento modul vy¾aduje bzip2/libbzip2 verze >= 1.0.x. </para> </section> - <section id="bzip2.installation"> - &reftitle.install; - <para> - Podpora bzip2 není v PHP implicitnì k dispozici. K aktivaci budete muset - pøi kompilaci PHP pou¾ít konfiguraèní volbu - <link linkend="install.configure.with-bz2">--with-bz2</link>. Tento modul - vy¾aduje bzip2/libbzip2 verze >= 1.0.x. - </para> - </section> + &reference.bzip2.configure; <section id="bzip2.configuration"> &reftitle.runtime; Index: phpdoc-cs/reference/bzip2/functions/bzopen.xml diff -u phpdoc-cs/reference/bzip2/functions/bzopen.xml:1.1 phpdoc-cs/reference/bzip2/functions/bzopen.xml:1.2 --- phpdoc-cs/reference/bzip2/functions/bzopen.xml:1.1 Sat Aug 3 18:55:51 2002 +++ phpdoc-cs/reference/bzip2/functions/bzopen.xml Mon Dec 8 10:12:56 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: luk Status: ready --> <refentry id="function.bzopen"> <refnamediv> @@ -30,7 +30,10 @@ <![CDATA[ <?php $bz = bzopen("/tmp/foo.bz2", "r"); -$decompressed_file = bzread($bz, filesize("/tmp/foo.bz2")); +$decompressed_file = ''; +while (!feof($bz)) { + $decompressed_file .= bzread($bz, 4096); +} bzclose($bz); print( "Obsah souboru /tmp/foo.bz2 je: " ); Index: phpdoc-cs/reference/datetime/reference.xml diff -u phpdoc-cs/reference/datetime/reference.xml:1.1 phpdoc-cs/reference/datetime/reference.xml:1.2 --- phpdoc-cs/reference/datetime/reference.xml:1.1 Sat Aug 3 18:55:51 2002 +++ phpdoc-cs/reference/datetime/reference.xml Mon Dec 8 10:12:57 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.3 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: luk Status: ready --> <reference id="ref.datetime"> <title>Funkce pro datum a èas</title> @@ -8,14 +8,14 @@ <section id="datetime.intro"> &reftitle.intro; <para> - Tyto funkce mù¾ete pou¾ít k práci s datem a èasem. Umo¾òují získat datum - a èas ze serveru, na kterém PHP bì¾í. Lze je pou¾ít k formátování zápisu + Tyto funkce vám umo¾òují získat datum a èas ze serveru, + na kterém bì¾í PHP skripty. Lze je pou¾ít k formátování zápisu èasu a data mnoha rùznými zpùsoby. </para> <note> <simpara> Uvìdomte si prosím, ¾e tyto funkce závisí na národním nastavení va¹eho - serveru. Zvlá¹tní pozornost vìnujte letnímu èasu a pøestupným rokùm! + serveru. Zvlá¹tní pozornost vìnujte letnímu èasu a pøestupným rokùm! </simpara> </note> Index: phpdoc-cs/reference/datetime/functions/checkdate.xml diff -u phpdoc-cs/reference/datetime/functions/checkdate.xml:1.1 phpdoc-cs/reference/datetime/functions/checkdate.xml:1.2 --- phpdoc-cs/reference/datetime/functions/checkdate.xml:1.1 Sat Aug 3 18:55:51 2002 +++ phpdoc-cs/reference/datetime/functions/checkdate.xml Mon Dec 8 10:12:58 2003 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: luk Status: ready --> <refentry id="function.checkdate"> <refnamediv> <refname>checkdate</refname> - <refpurpose>Zkontroluje gregoriánské datum/èas</refpurpose> + <refpurpose>Zkontroluje gregoriánské datum</refpurpose> </refnamediv> <refsect1> <title>Popis</title> Index: phpdoc-cs/reference/datetime/functions/date.xml diff -u phpdoc-cs/reference/datetime/functions/date.xml:1.1 phpdoc-cs/reference/datetime/functions/date.xml:1.2 --- phpdoc-cs/reference/datetime/functions/date.xml:1.1 Sat Aug 3 18:55:51 2002 +++ phpdoc-cs/reference/datetime/functions/date.xml Mon Dec 8 10:12:58 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.4 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.9 Maintainer: luk Status: ready --> <refentry id="function.date"> <refnamediv> @@ -17,7 +17,8 @@ <para> Vrací øetìzec formátovaný podle daného formátovacího øetìzce s pou¾itím daného celoèíselného èasového razítka <parameter>timestamp</parameter> - nebo aktuálního místního èasu (není-li èasové razítko zadáno). + nebo aktuálního místního èasu (není-li èasové razítko zadáno). Jinými slovy, parametr <parameter>timestamp</parameter> + je nepovinný a jeho výchozí hodnota je výsledek funkce <function>time</function>. <note> <para> Platný rozsah pro èasové razítko je typicky od pátku 13.12.1901 @@ -29,183 +30,206 @@ K vygenerování èasového razítka z øetìzce reprezentujícího datum lze pou¾ít funkci <function>strtotime</function>. Navíc nìkteré databáze mají funkce, které konvertují jejich datové formáty na - èasová razítka (napø. funce UNIX_TIMESTAMP v MySQL). + èasová razítka (napø. funce <ulink url="&url.mysql.docs.date;">UNIX_TIMESTAMP</ulink> v MySQL). </para> </note> </para> <para> - Ve formátovacím øetìzci lze pou¾ívat tyto znaky: - <itemizedlist> - <listitem> - <simpara> - a - "am" nebo "pm" - </simpara> - </listitem> - <listitem> - <simpara> - A - "AM" nebo "PM" - </simpara> - </listitem> - <listitem> - <simpara> - B - internetový èas Swatch ("zavináèe") - </simpara> - </listitem> - <listitem> - <simpara> - d - den v mìsíci, 2 èíslice s úvodními nulami, "01" a¾ "31" - </simpara> - </listitem> - <listitem> - <simpara> - D - den v týdnu, textovì, 3 písmena, napø. "Fri" - </simpara> - </listitem> - <listitem> - <simpara> - F - mìsíc, textovì, dlouhý název, napø. "January" - </simpara> - </listitem> - <listitem> - <simpara> - g - hodina, 12-hodinový formát bez úvodních nul, "1" a¾ "12" - </simpara> - </listitem> - <listitem> - <simpara> - G - hodina, 24-hodinový formát bez úvodních nul, "0" a¾ "23" - </simpara> - </listitem> - <listitem> - <simpara> - h - hodina, 12-hodinový formát, "01" a¾ "12" - </simpara> - </listitem> - <listitem> - <simpara> - H - hodina, 24-hodinový formát, "00" a¾ "23" - </simpara> - </listitem> - <listitem> - <simpara> - i - minuty, "00" a¾ "59" - </simpara> - </listitem> - <listitem> - <simpara> - I (velké i) - "1" pro letní èas, jinak "0" - </simpara> - </listitem> - <listitem> - <simpara> - j - den v mìsíci bez úvodních nul, napø. "1" a¾ "31" - </simpara> - </listitem> - <listitem> - <simpara> - l (malé 'L') - den v týdnu, textovì, dlouhý název, napø. "Friday" - </simpara> - </listitem> - <listitem> - <simpara> - L - pravdivostní hodnota urèující, zda je pøestupný rok, "0" nebo "1" - </simpara> - </listitem> - <listitem> - <simpara> - m - mìsíc, "01" a¾ "12" - </simpara> - </listitem> - <listitem> - <simpara> - M - mìsíc, textovì, 3 písmena, napø. "Jan" - </simpara> - </listitem> - <listitem> - <simpara> - n - mìsíc bez úvodních nul, "1" a¾ "12" - </simpara> - </listitem> - <listitem> - <simpara> - O - odchylka od greenwichského èasu v hodinách, napø. "+0200" - </simpara> - </listitem> - <listitem> - <simpara> - r - datum formátované podle RFC 822, napø. - "Thu, 21 Dec 2000 16:01:07 +0200" (pøidáno v PHP 4.0.4) - </simpara> - </listitem> - <listitem> - <simpara> - s - sekundy, "00" a¾ "59" - </simpara> - </listitem> - <listitem> - <simpara> - S - anglická pøípona øadové èíslovky pro den v mìsíci, 2 znaky, - "st", "nd", "rd" nebo "th" - </simpara> - </listitem> - <listitem> - <simpara> - t - poèet dní v daném mìsíci, "28" a¾ "31" - </simpara> - </listitem> - <listitem> - <simpara> - T - èasová zóna nastavená na serveru, napø. "EST" nebo "MDT" - </simpara> - </listitem> - <listitem> - <simpara> - U - sekundy od Unix Epoch (1.1.1970 00:00:00 GMT) - </simpara> - </listitem> - <listitem> - <simpara> - w - den v týdnu, èíselnì, "0" (nedìle) a¾ "6" (sobota) - </simpara> - </listitem> - <listitem> - <simpara> - W - poèet týdnù v roce podle ISO-8601, týden zaèíná v pondìlí - (pøidáno v PHP 4.1.0) - </simpara> - </listitem> - <listitem> - <simpara> - Y - rok, 4 èíslice, napø. "1999" - </simpara> - </listitem> - <listitem> - <simpara> - y - rok, 2 èíslice, napø. "99" - </simpara> - </listitem> - <listitem> - <simpara> - z - den v roce, "0" a¾ "365" - </simpara> - </listitem> - <listitem> - <simpara> - Z - èasový posun v sekundách ("-43200" a¾ "43200"). Posun má pro èasové - zóny na západ od UTC zápornou hodnotu, na východ kladnou. - </simpara> - </listitem> - </itemizedlist> + <table> + <title>Ve formátovacím øetìzci lze pou¾ívat tyto + znaky:</title> + <tgroup cols="3"> + <thead> + <row> + <entry>znak parametru <parameter>format</parameter></entry> + <entry>Popis</entry> + <entry>Ukázka vracených hodnot</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>a</literal></entry> + <entry>Pøíznak dopoledne/odpoledne malými písmeny</entry> + <entry><literal>am</literal> nebo <literal>pm</literal></entry> + </row> + <row> + <entry><literal>A</literal></entry> + <entry>Pøíznak dopoledne/odpoledne velkými písmeny</entry> + <entry><literal>AM</literal> nebo <literal>PM</literal></entry> + </row> + <row> + <entry><literal>B</literal></entry> + <entry>Internetový èas Swatch</entry> + <entry><literal>000</literal> a¾ <literal>999</literal></entry> + </row> + <row> + <entry><literal>d</literal></entry> + <entry>Den mìsíce, dvì èíslice s úvodními nulami</entry> + <entry><literal>01</literal> a¾ <literal>31</literal></entry> + </row> + <row> + <entry><literal>D</literal></entry> + <entry>Textová reprezentace dne, tøi znaky</entry> + <entry><literal>Mon</literal> a¾ <literal>Sun</literal></entry> + </row> + <row> + <entry><literal>F</literal></entry> + <entry>Plná textová reprezentace mìsíce typu January nebo March</entry> + <entry><literal>January</literal> a¾ <literal>December</literal></entry> + </row> + <row> + <entry><literal>g</literal></entry> + <entry>12-hodinový formát hodiny bez úvodních nul</entry> + <entry><literal>1</literal> a¾ <literal>12</literal></entry> + </row> + <row> + <entry><literal>G</literal></entry> + <entry>24-hodinový formát hodiny bez úvodních nul</entry> + <entry><literal>0</literal> a¾ <literal>23</literal></entry> + </row> + <row> + <entry><literal>h</literal></entry> + <entry>12-hodinový formát hodiny s úvodními nulami</entry> + <entry><literal>01</literal> a¾ <literal>12</literal></entry> + </row> + <row> + <entry><literal>H</literal></entry> + <entry>24-hodinový formát hodiny s úvodními nulami</entry> + <entry><literal>00</literal> a¾ <literal>23</literal></entry> + </row> + <row> + <entry><literal>i</literal></entry> + <entry>Minuty s úvodními nulami</entry> + <entry><literal>00</literal> a¾ <literal>59</literal></entry> + </row> + <row> + <entry><literal>I</literal> (velké i)</entry> + <entry>Zji¹tìní, zda je letní èas</entry> + <entry><literal>1</literal> pokud je letní èas, <literal>0</literal> jinak.</entry> + </row> + <row> + <entry><literal>j</literal></entry> + <entry>Den mìsíce bez úvodních nul</entry> + <entry><literal>1</literal> a¾ <literal>31</literal></entry> + </row> + <row> + <entry><literal>l</literal> (malé 'L')</entry> + <entry>Plná textová reprezentace dne v týdnu</entry> + <entry><literal>Sunday</literal> a¾ <literal>Saturday</literal></entry> + </row> + <row> + <entry><literal>L</literal></entry> + <entry>Zji¹tìní, zda je rok pøestupný</entry> + <entry><literal>1</literal> pokud je pøestupný rok, <literal>0</literal> jinak.</entry> + </row> + <row> + <entry><literal>m</literal></entry> + <entry>Èíselná reprezentace mìsíce s úvodními nulami</entry> + <entry><literal>01</literal> a¾ <literal>12</literal></entry> + </row> + <row> + <entry><literal>M</literal></entry> + <entry>Krátká textová reprezentace mìsíce, tøi znaky</entry> + <entry><literal>Jan</literal> a¾ <literal>Dec</literal></entry> + </row> + <row> + <entry><literal>n</literal></entry> + <entry>Èíselná reprezentace mìsíce bez úvodních nul</entry> + <entry><literal>1</literal> a¾ <literal>12</literal></entry> + </row> + <row> + <entry><literal>O</literal></entry> + <entry>Odchylka od Greenwichského èasu (GMT) v hodinách</entry> + <entry>Pøíklad: <literal>+0200</literal></entry> + </row> + <row> + <entry><literal>r</literal></entry> + <entry>Datum formátované podle RFC 822</entry> + <entry>Pøíklad: <literal>Thu, 21 Dec 2000 16:01:07 +0200</literal></entry> + </row> + <row> + <entry><literal>s</literal></entry> + <entry>Sekundy s úvodními nulami</entry> + <entry><literal>00</literal> a¾ <literal>59</literal></entry> + </row> + <row> + <entry><literal>S</literal></entry> + <entry>Anglická poøadová pøípona dne v mìsíci, 2 znaky</entry> + <entry> + <literal>st</literal>, <literal>nd</literal>, <literal>rd</literal> nebo + <literal>th</literal>. Dobøe funguje s <literal>j</literal> + </entry> + </row> + <row> + <entry><literal>t</literal></entry> + <entry>Poèet dní v daném mìsíci</entry> + <entry><literal>28</literal> a¾ <literal>31</literal></entry> + </row> + <row> + <entry><literal>T</literal></entry> + <entry>Nastavení èasového pásma na tomto poèítaèi</entry> + <entry>Pøíklady: <literal>EST</literal>, <literal>MDT</literal> ...</entry> + </row> + <row> + <entry><literal>U</literal></entry> + <entry>Sekundy od poèátku éry Unix (1. ledna 1970 00:00:00 GMT)</entry> + <entry>Viz také <function>time</function></entry> + </row> + <row> + <entry><literal>w</literal></entry> + <entry>Èíselná reprezentace dne v týdnu</entry> + <entry><literal>0</literal> (pro nedìli) a¾ <literal>6</literal> (pro sobotu)</entry> + </row> + <row> + <entry><literal>W</literal></entry> + <entry>Èíslo týdne podle ISO-8601, týdny zaèínají v pondìlí (doplnìno v PHP 4.1.0)</entry> + <entry>Pøíklad: <literal>42</literal> (42. týden v roce)</entry> + </row> + <row> + <entry><literal>Y</literal></entry> + <entry>Plná èíselná reprezentace roku, 4 èíslice</entry> + <entry>Pøíklady: <literal>1999</literal> nebo <literal>2003</literal></entry> + </row> + <row> + <entry><literal>y</literal></entry> + <entry>Dvouciferná reprezentace roku</entry> + <entry>Pøíklady: <literal>99</literal> nebo <literal>03</literal></entry> + </row> + <row> + <entry><literal>z</literal></entry> + <entry>Den v roce</entry> + <entry><literal>0</literal> a¾ <literal>366</literal></entry> + </row> + <row> + <entry><literal>Z</literal></entry> + <entry>Posun èasového pásma v sekundách. Posun èasových pásem západnì od UTC je v¾dy + záporný, východnì od UTC je v¾dy kladný.</entry> + <entry><literal>-43200</literal> a¾ <literal>43200</literal></entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> Nerozpoznané znaky ve formátovacím øetìzci se vytiskou tak, jak jsou. - Pøi pou¾ití <function>gmdate</function> má formát "Z" v¾dy hodnotu 0. + Pøi pou¾ití <function>gmdate</function> má formát <literal>Z</literal> + v¾dy hodnotu <literal>0</literal>. </para> <para> <example> - <title>Pøíklad - <function>date</function></title> + <title>Pøíklady - <function>date</function></title> <programlisting role="php"> <![CDATA[ +<?php +// Vytiskne nìco jako: Wednesday +echo date("l"); + +// Vytiskne nìco jako: Wednesday 15th of January 2003 05:51:38 AM echo date ("l dS of F Y h:i:s A"); + +// Vytiskne: 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> @@ -219,7 +243,10 @@ <title>Ochrana znakù ve funkci <function>date</function></title> <programlisting role="php"> <![CDATA[ -echo date("l \\t\h\e jS"); // vytiskne nìco jako 'Saturday the 8th' +<?php +// vytiskne nìco jako 'Saturday the 8th' +echo date("l \\t\h\e jS"); +?> ]]> </programlisting> </example> @@ -232,9 +259,11 @@ </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> @@ -258,7 +287,8 @@ </title> <programlisting role="php"> <![CDATA[ -/* Dnes je 10. bøezna 2001, 5:16:18 odpoledne */ +<?php +// Pøedpokládejme, ¾e dnes je 10. bøezna 2001, 17:16:18 $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 @@ -268,6 +298,7 @@ $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> Index: phpdoc-cs/reference/datetime/functions/getdate.xml diff -u phpdoc-cs/reference/datetime/functions/getdate.xml:1.1 phpdoc-cs/reference/datetime/functions/getdate.xml:1.2 --- phpdoc-cs/reference/datetime/functions/getdate.xml:1.1 Sat Aug 10 19:37:15 2002 +++ phpdoc-cs/reference/datetime/functions/getdate.xml Mon Dec 8 10:12:58 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.8 Maintainer: luk Status: ready --> <refentry id="function.getdate"> <refnamediv> @@ -16,73 +16,121 @@ Vrací asociativní pole obsahující informaci o datu (èase) v argumentu <parameter>timestamp</parameter> nebo aktuální místní èas (pokud není argument pøítomen), jako tyto elementy: - <itemizedlist> - <listitem> - <simpara> - "seconds" - sekundy - </simpara> - </listitem> - <listitem> - <simpara> - "minutes" - minuty - </simpara> - </listitem> - <listitem> - <simpara> - "hours" - hodiny - </simpara> - </listitem> - <listitem> - <simpara> - "mday" - den v mìsíci - </simpara> - </listitem> - <listitem> - <simpara> - "wday" - den v týdnu, èíselnì: od 0 (nedìle) do 6 (sobota) - </simpara> - </listitem> - <listitem> - <simpara> - "mon" - mìsíc, èíselnì - </simpara> - </listitem> - <listitem> - <simpara> - "year" - rok, èíselnì - </simpara> - </listitem> - <listitem> - <simpara> - "yday" - den v roce, èíselnì; napø. "299" - </simpara> - </listitem> - <listitem> - <simpara> - "weekday" - den v týdnu, textovì, plný název; napø. "Friday" - </simpara> - </listitem> - <listitem> - <simpara> - "month" - mìsíc, textovì, plný název; napø. "January" - </simpara> - </listitem> - </itemizedlist> + </para> + <para> + <table> + <title>Klíèe vráceného asociativního pole</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Klíè</entry> + <entry>Popis</entry> + <entry>Ukázka vracených hodnot</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>"seconds"</literal></entry> + <entry>Èíselná reprezentace sekund</entry> + <entry><literal>0</literal> a¾ <literal>59</literal></entry> + </row> + <row> + <entry><literal>"minutes"</literal></entry> + <entry>Èíselná reprezentace minut</entry> + <entry><literal>0</literal> a¾ <literal>59</literal></entry> + </row> + <row> + <entry><literal>"hours"</literal></entry> + <entry>Èíselná reprezentace hodin</entry> + <entry><literal>0</literal> a¾ <literal>23</literal></entry> + </row> + <row> + <entry><literal>"mday"</literal></entry> + <entry>Èíselná reprezentace dne v mìsíci</entry> + <entry><literal>1</literal> a¾ <literal>31</literal></entry> + </row> + <row> + <entry><literal>"wday"</literal></entry> + <entry>Èíselná reprezentace dne v týdnu</entry> + <entry><literal>0</literal> (pro nedìli) a¾ <literal>6</literal> (pro sobotu)</entry> + </row> + <row> + <entry><literal>"mon"</literal></entry> + <entry>Èíselná reprezentace mìsíce</entry> + <entry><literal>1</literal> a¾ <literal>12</literal></entry> + </row> + <row> + <entry><literal>"year"</literal></entry> + <entry>Plná èíselná reprezentace roku, 4 èíslice</entry> + <entry>Pøíklady: <literal>1999</literal> nebo <literal>2003</literal></entry> + </row> + <row> + <entry><literal>"yday"</literal></entry> + <entry>Èíselná reprezentace dne v roce</entry> + <entry><literal>0</literal> a¾ <literal>366</literal></entry> + </row> + <row> + <entry><literal>"weekday"</literal></entry> + <entry>Plná textová reprezentace dne v týdnu</entry> + <entry><literal>Sunday</literal> a¾ <literal>Saturday</literal></entry> + </row> + <row> + <entry><literal>"month"</literal></entry> + <entry>Plná textová reprezentace mìsíce</entry> + <entry><literal>January</literal> a¾ <literal>December</literal></entry> + </row> + <row> + <entry><literal>0</literal></entry> + <entry>Sekundy éry Unixu, obdobnì jako hodnoty vracené funkcí + <function>time</function> a pou¾ívané funkcí <function>date</function>.</entry> + <entry>Závislé na systému, typicky <literal>-2147483648</literal> a¾ + <literal>2147483647</literal>.</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> <example> <title> Pøíklad - <function>getdate</function> </title> <programlisting role="php"> <![CDATA[ -$today = getdate(); -$month = $today['month']; -$mday = $today['mday']; -$year = $today['year']; -echo "$month $mday, $year"; +<?php +$today = getdate(); +print_r($today); +?> ]]> </programlisting> + <para> + Výstup bude vypadat zhruba takto: + </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> + Viz také <function>date</function>, + <function>time</function> a + <function>setlocale</function>. + </para> </refsect1> </refentry> Index: phpdoc-cs/reference/datetime/functions/gmdate.xml diff -u phpdoc-cs/reference/datetime/functions/gmdate.xml:1.1 phpdoc-cs/reference/datetime/functions/gmdate.xml:1.2 --- phpdoc-cs/reference/datetime/functions/gmdate.xml:1.1 Tue Sep 3 16:20:51 2002 +++ phpdoc-cs/reference/datetime/functions/gmdate.xml Mon Dec 8 10:12:58 2003 @@ -1,9 +1,9 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: luk Status: ready --> <refentry id="function.gmdate"> <refnamediv> <refname>gmdate</refname> - <refpurpose>Formátuje datum/èas GMT/CUT</refpurpose> + <refpurpose>Formátuje datum/èas GMT/UTC</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -21,12 +21,34 @@ <title>Pøíklad - <function>gmdate</function></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> + V operaèním systému Microsoft Windows jsou systémové + knihovny implementující tuto funkci po¹kozené, tak¾e + funkce <function>gmdate</function> nepodporuje negativní hodnoty + parametru <parameter>timestamp</parameter>. + Blí¾e viz bug-reporty: + <ulink url="&url.php.bugs;22620">#22620</ulink>, + <ulink url="&url.php.bugs;22457">#22457</ulink> + a <ulink url="&url.php.bugs;14391">#14391</ulink>. + </para> + <para> + K tomuto problému nedochází v operaèních systémech Unix/Linux, kde + se systémové knihovny chovají podle oèekávání. + </para> + <para> + PHP nemá moc opravit po¹kozené systémové knihovny. Kontaktujte + prodejce svého OS, aby tento a podobné problémy opravil. + </para> + </note> <para> Viz také <function>date</function>, <function>mktime</function>, <function>gmmktime</function> a <function>strftime</function>. Index: phpdoc-cs/reference/datetime/functions/gmmktime.xml diff -u phpdoc-cs/reference/datetime/functions/gmmktime.xml:1.1 phpdoc-cs/reference/datetime/functions/gmmktime.xml:1.2 --- phpdoc-cs/reference/datetime/functions/gmmktime.xml:1.1 Tue Sep 3 16:20:51 2002 +++ phpdoc-cs/reference/datetime/functions/gmmktime.xml Mon Dec 8 10:12:58 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: luk Status: ready --> <refentry id="function.gmmktime"> <refnamediv> <refname>gmmktime</refname> @@ -9,18 +9,23 @@ <title>Popis</title> <methodsynopsis> <type>int</type><methodname>gmmktime</methodname> - <methodparam><type>int</type><parameter>hour</parameter></methodparam> - <methodparam><type>int</type><parameter>minute</parameter></methodparam> - <methodparam><type>int</type><parameter>second</parameter></methodparam> - <methodparam><type>int</type><parameter>month</parameter></methodparam> - <methodparam><type>int</type><parameter>day</parameter></methodparam> - <methodparam><type>int</type><parameter>year</parameter></methodparam> + <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> Identické k <function>mktime</function>, kromì toho, ¾e parametry reprezentují datum/èas v GMT. </para> + <para> + Podobnì jako u funkce <function>mktime</function> mohou být parametry vynechány v poøadí + zprava doleva. Neuvedené parametry budou nastaveny + na odpovídající hodnotu souèasného GMT. + </para> </refsect1> </refentry> Index: phpdoc-cs/reference/datetime/functions/gmstrftime.xml diff -u phpdoc-cs/reference/datetime/functions/gmstrftime.xml:1.1 phpdoc-cs/reference/datetime/functions/gmstrftime.xml:1.2 --- phpdoc-cs/reference/datetime/functions/gmstrftime.xml:1.1 Tue Sep 3 16:20:51 2002 +++ phpdoc-cs/reference/datetime/functions/gmstrftime.xml Mon Dec 8 10:12:58 2003 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.3 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: luk Status: ready --> <refentry id="function.gmstrftime"> <refnamediv> <refname>gmstrftime</refname> <refpurpose> - Formátuje datum/èas v GMT/CUT vzhledem k národnímu nastavení + Formátuje datum/èas v GMT/UTC vzhledem k národnímu nastavení </refpurpose> </refnamediv> <refsect1> @@ -23,9 +23,11 @@ <title><function>gmstrftime</function> example</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> Index: phpdoc-cs/reference/datetime/functions/localtime.xml diff -u phpdoc-cs/reference/datetime/functions/localtime.xml:1.1 phpdoc-cs/reference/datetime/functions/localtime.xml:1.2 --- phpdoc-cs/reference/datetime/functions/localtime.xml:1.1 Tue Sep 3 16:20:51 2002 +++ phpdoc-cs/reference/datetime/functions/localtime.xml Mon Dec 8 10:12:58 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: luk Status: ready --> <refentry id="function.localtime"> <refnamediv> @@ -21,7 +21,8 @@ Funkce <function>localtime</function> vrací pole strukturálnì identické k návratové hodnotì volání v C. První argument funkce <function>localtime</function> je èasové razítko; není-li dáno, pou¾ije - se aktuální èas. Druhý argument <function>localtime</function> je + se aktuální èas, který vrátí funkce <function>time</function>. + Druhý argument <function>localtime</function> je <parameter>is_associative</parameter>, který (nastavením na nulu) signalizuje, ¾e vracené pole je obyèejné, èíselnì indexované pole. Je-li argument nastaven na 1, potom <function>localtime</function> Index: phpdoc-cs/reference/datetime/functions/microtime.xml diff -u phpdoc-cs/reference/datetime/functions/microtime.xml:1.1 phpdoc-cs/reference/datetime/functions/microtime.xml:1.2 --- phpdoc-cs/reference/datetime/functions/microtime.xml:1.1 Tue Sep 3 16:20:51 2002 +++ phpdoc-cs/reference/datetime/functions/microtime.xml Mon Dec 8 10:12:58 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: luk Status: ready --> <refentry id="function.microtime"> <refnamediv> @@ -25,6 +25,7 @@ <title>Pøíklad - <function>microtime</function></title> <programlisting role="php"> <![CDATA[ +<?php function getmicrotime(){ list($usec, $sec) = explode(" ",microtime()); return ((float)$usec + (float)$sec); @@ -40,6 +41,7 @@ $time = $time_end - $time_start; echo "Nic se nedìlalo $time sekund"; +?> ]]> </programlisting> </example> Index: phpdoc-cs/reference/datetime/functions/mktime.xml diff -u phpdoc-cs/reference/datetime/functions/mktime.xml:1.1 phpdoc-cs/reference/datetime/functions/mktime.xml:1.2 --- phpdoc-cs/reference/datetime/functions/mktime.xml:1.1 Tue Sep 3 16:20:51 2002 +++ phpdoc-cs/reference/datetime/functions/mktime.xml Mon Dec 8 10:12:58 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: luk Status: ready --> <refentry id="function.mktime"> <refnamediv> @@ -10,12 +10,12 @@ <title>Popis</title> <methodsynopsis> <type>int</type><methodname>mktime</methodname> - <methodparam><type>int</type><parameter>hour</parameter></methodparam> - <methodparam><type>int</type><parameter>minute</parameter></methodparam> - <methodparam><type>int</type><parameter>second</parameter></methodparam> - <methodparam><type>int</type><parameter>month</parameter></methodparam> - <methodparam><type>int</type><parameter>day</parameter></methodparam> - <methodparam><type>int</type><parameter>year</parameter></methodparam> + <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> @@ -54,10 +54,12 @@ <title>Pøíklad - <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> @@ -65,7 +67,17 @@ èíslicemi, s hodnotami 0-69 mapovanými na 2000-2069 a 70-99 na 1970-1999 (na systémech, kde time_t je 32bitové celé èíslo se znaménkem, jak je dnes obvyklé, budou platné hodnoty pro <parameter>year</parameter> - nìkde mezi 1902 a 2037). + nìkde mezi 1901 a 2038). + </para> + <para> + <note> + <title>Windows</title> + <simpara> + Záporné èasové znaèky nejsou podporovány v ¾ádné známé + verzi Windows. Platné rozmezí rokù je proto pouze 1970 + a¾ 2038. + </simpara> + </note> </para> <para> Poslední den daného mìsíce mù¾e být vyjádøen jako den "0" mìsíce pøí¹tího, @@ -75,11 +87,13 @@ <title>Poslední den mìsíce</title> <programlisting role="php"> <![CDATA[ +<?php $lastday = mktime (0,0,0,3,0,2000); echo strftime ("Last day in Feb 2000 is: %d", $lastday); $lastday = mktime (0,0,0,4,-31,2000); echo strftime ("Last day in Feb 2000 is: %d", $lastday); +?> ]]> </programlisting> </example> Index: phpdoc-cs/reference/datetime/functions/strftime.xml diff -u phpdoc-cs/reference/datetime/functions/strftime.xml:1.1 phpdoc-cs/reference/datetime/functions/strftime.xml:1.2 --- phpdoc-cs/reference/datetime/functions/strftime.xml:1.1 Thu Sep 26 16:22:18 2002 +++ phpdoc-cs/reference/datetime/functions/strftime.xml Mon Dec 8 10:12:58 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.10 Maintainer: luk Status: ready --> <refentry id="function.strftime"> <refnamediv> @@ -228,30 +228,100 @@ <para> V¹echny konverzní specifikátory nemusí být podporovány va¹í C knihovnou, potom nebudou podporovány ani funkcí <function>strftime</function> - v PHP. To znamená, ¾e %T a %D nebudou fungovat na Windows. + v PHP. Kromì toho také ne v¹echny platformy + podporují práci s negativními èasovými znaèkami, tak¾e rozsah mo¾ných datumù + mù¾e být omezen zaèátkem éry Unixu. To znamená, ¾e + napø. %e, %T, %R a %D (a pøípadnì i dal¹í) a datumy pøedcházející + <literal>1.1.1970</literal> nebudou fungovat pod Windows, nìkterými distribucemi + Linuxu a nìkolika dal¹ími operaèními systémy. Pro Windows lze + kompletní pøehled podporovaných konverzních specifikátorù najít na + <ulink url="&url.strftime.win32;">webových stránkách <acronym>MSDN</acronym></ulink>. + </para> </note> <example> - <title>Pøíklad - <function>strftime</function></title> + <title><function>strftime</function> - místní pøíklady</title> <programlisting role="php"> <![CDATA[ -setlocale (LC_TIME, "C"); -print (strftime ("%A je ve fin¹tinì ")); -setlocale (LC_TIME, "fi_FI"); -print (strftime ("%A, ve francouz¹tinì ")); -setlocale (LC_TIME, "fr_FR"); -print (strftime ("%A a v nìmèinì ")); -setlocale (LC_TIME, "de_DE"); -print (strftime ("%A.\n")); +<?php +setlocale(LC_TIME, "C"); +echo strftime("%A"); +setlocale(LC_TIME, "fi_FI"); +echo strftime(" je ve fin¹tinì %A,"); +setlocale(LC_TIME, "fr_FR"); +echo strftime(" ve francouz¹tinì %A a"); +setlocale(LC_TIME, "de_DE"); +echo strftime(" v nìmèinì %A.\n"); +?> ]]> </programlisting> </example> Tento pøíklad bude fungovat jen tehdy, máte-li daná národní specifika nainstalována v systému. + <note> + <simpara> + %G a %V, které jsou zalo¾eny na normì ISO 8601:1988, mohou + vrátit neoèekávané (a pøesto správné) výsledky, pokud nemáte v èíslovacím systému + zcela jasno. Viz %V vý¹e a pøíklad ní¾e. + </simpara> + </note> + <example> + <title>Pøíklad èísel týdnù podle ISO 8601:1988</title> + <programlisting role="php"> +<![CDATA[ +<?php +/* December 2002 / January 2003 +ISOWk M Tu W Thu F Sa Su +----- ---------------------------- +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 */ + +// Vypí¹e: 28.12.2002 - %V,%G,%Y = 52,2002,2002 +echo "28.12.2002 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/28/2002")) . "\n"; + +// Vypí¹e: 30.12.2002 - %V,%G,%Y = 1,2003,2002 +echo "30.12.2002 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/30/2002")) . "\n"; + +// Vypí¹e: 3.1.2003 - %V,%G,%Y = 1,2003,2003 +echo "3.1.2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2003")) . "\n"; + +// Vypí¹e: 10.1.2003 - %V,%G,%Y = 2,2003,2003 +echo "10.1.2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/10/2003")) . "\n"; + + + +/* December 2004 / January 2005 +ISOWk M Tu W Thu F Sa Su +----- ---------------------------- +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 */ + +// Vypí¹e: 23.12.2004 - %V,%G,%Y = 52,2004,2004 +echo "23.12.2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/23/2004")) . "\n"; + +// Vypí¹e: 31.12.2004 - %V,%G,%Y = 53,2004,2004 +echo "31.12.2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/31/2004")) . "\n"; + +// Vypí¹e: 2.1.2005 - %V,%G,%Y = 53,2004,2005 +echo "2.1.2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/2/2005")) . "\n"; + +// Vypí¹e: 3.1.2005 - %V,%G,%Y = 1,2005,2005 +echo "3.1.2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2005")) . "\n"; + +?> +]]> + </programlisting> + </example> </para> <para> - Viz také <function>setlocale</function> a - <function>mktime</function>, a <ulink url="&spec.strftime;"> + Viz také <function>setlocale</function>, + <function>mktime</function> a <ulink url="&spec.strftime;"> specifikaci Open Group <function>strftime</function></ulink>. </para> Index: phpdoc-cs/reference/bzip2/configure.xml +++ phpdoc-cs/reference/bzip2/configure.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.4 Maintainer: luk Status: ready --> <section id="bzip2.installation"> &reftitle.install; <para> Podpora bzip2 není v PHP implicitnì k dispozici. K aktivaci budete muset pøi kompilaci PHP pou¾ít konfiguraèní volbu <option role="configure">--with-bz2[=DIR]</option>. </para> </section> <!-- 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 -->
Index: phpdoc-cs/reference/bzip2/reference.xml diff -u phpdoc-cs/reference/bzip2/reference.xml:1.1 phpdoc-cs/reference/bzip2/reference.xml:1.2 --- phpdoc-cs/reference/bzip2/reference.xml:1.1 Fri Jun 21 17:42:31 2002 +++ phpdoc-cs/reference/bzip2/reference.xml Mon Dec 8 10:12:54 2003 @@ -19,18 +19,11 @@ <para> Tento modul pou¾ívá funkce z knihovny <ulink url="&url.bzip2;">bzip2</ulink> od Juliana Sewarda. + Tento modul vy¾aduje bzip2/libbzip2 verze >= 1.0.x. </para> </section> - <section id="bzip2.installation"> - &reftitle.install; - <para> - Podpora bzip2 není v PHP implicitnì k dispozici. K aktivaci budete muset - pøi kompilaci PHP pou¾ít konfiguraèní volbu - <link linkend="install.configure.with-bz2">--with-bz2</link>. Tento modul - vy¾aduje bzip2/libbzip2 verze >= 1.0.x. - </para> - </section> + &reference.bzip2.configure; <section id="bzip2.configuration"> &reftitle.runtime; Index: phpdoc-cs/reference/bzip2/functions/bzopen.xml diff -u phpdoc-cs/reference/bzip2/functions/bzopen.xml:1.1 phpdoc-cs/reference/bzip2/functions/bzopen.xml:1.2 --- phpdoc-cs/reference/bzip2/functions/bzopen.xml:1.1 Sat Aug 3 18:55:51 2002 +++ phpdoc-cs/reference/bzip2/functions/bzopen.xml Mon Dec 8 10:12:56 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: luk Status: ready --> <refentry id="function.bzopen"> <refnamediv> @@ -30,7 +30,10 @@ <![CDATA[ <?php $bz = bzopen("/tmp/foo.bz2", "r"); -$decompressed_file = bzread($bz, filesize("/tmp/foo.bz2")); +$decompressed_file = ''; +while (!feof($bz)) { + $decompressed_file .= bzread($bz, 4096); +} bzclose($bz); print( "Obsah souboru /tmp/foo.bz2 je: " ); Index: phpdoc-cs/reference/datetime/reference.xml diff -u phpdoc-cs/reference/datetime/reference.xml:1.1 phpdoc-cs/reference/datetime/reference.xml:1.2 --- phpdoc-cs/reference/datetime/reference.xml:1.1 Sat Aug 3 18:55:51 2002 +++ phpdoc-cs/reference/datetime/reference.xml Mon Dec 8 10:12:57 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.3 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: luk Status: ready --> <reference id="ref.datetime"> <title>Funkce pro datum a èas</title> @@ -8,14 +8,14 @@ <section id="datetime.intro"> &reftitle.intro; <para> - Tyto funkce mù¾ete pou¾ít k práci s datem a èasem. Umo¾òují získat datum - a èas ze serveru, na kterém PHP bì¾í. Lze je pou¾ít k formátování zápisu + Tyto funkce vám umo¾òují získat datum a èas ze serveru, + na kterém bì¾í PHP skripty. Lze je pou¾ít k formátování zápisu èasu a data mnoha rùznými zpùsoby. </para> <note> <simpara> Uvìdomte si prosím, ¾e tyto funkce závisí na národním nastavení va¹eho - serveru. Zvlá¹tní pozornost vìnujte letnímu èasu a pøestupným rokùm! + serveru. Zvlá¹tní pozornost vìnujte letnímu èasu a pøestupným rokùm! </simpara> </note> Index: phpdoc-cs/reference/datetime/functions/checkdate.xml diff -u phpdoc-cs/reference/datetime/functions/checkdate.xml:1.1 phpdoc-cs/reference/datetime/functions/checkdate.xml:1.2 --- phpdoc-cs/reference/datetime/functions/checkdate.xml:1.1 Sat Aug 3 18:55:51 2002 +++ phpdoc-cs/reference/datetime/functions/checkdate.xml Mon Dec 8 10:12:58 2003 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: luk Status: ready --> <refentry id="function.checkdate"> <refnamediv> <refname>checkdate</refname> - <refpurpose>Zkontroluje gregoriánské datum/èas</refpurpose> + <refpurpose>Zkontroluje gregoriánské datum</refpurpose> </refnamediv> <refsect1> <title>Popis</title> Index: phpdoc-cs/reference/datetime/functions/date.xml diff -u phpdoc-cs/reference/datetime/functions/date.xml:1.1 phpdoc-cs/reference/datetime/functions/date.xml:1.2 --- phpdoc-cs/reference/datetime/functions/date.xml:1.1 Sat Aug 3 18:55:51 2002 +++ phpdoc-cs/reference/datetime/functions/date.xml Mon Dec 8 10:12:58 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.4 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.9 Maintainer: luk Status: ready --> <refentry id="function.date"> <refnamediv> @@ -17,7 +17,8 @@ <para> Vrací øetìzec formátovaný podle daného formátovacího øetìzce s pou¾itím daného celoèíselného èasového razítka <parameter>timestamp</parameter> - nebo aktuálního místního èasu (není-li èasové razítko zadáno). + nebo aktuálního místního èasu (není-li èasové razítko zadáno). Jinými slovy, parametr <parameter>timestamp</parameter> + je nepovinný a jeho výchozí hodnota je výsledek funkce <function>time</function>. <note> <para> Platný rozsah pro èasové razítko je typicky od pátku 13.12.1901 @@ -29,183 +30,206 @@ K vygenerování èasového razítka z øetìzce reprezentujícího datum lze pou¾ít funkci <function>strtotime</function>. Navíc nìkteré databáze mají funkce, které konvertují jejich datové formáty na - èasová razítka (napø. funce UNIX_TIMESTAMP v MySQL). + èasová razítka (napø. funce <ulink url="&url.mysql.docs.date;">UNIX_TIMESTAMP</ulink> v MySQL). </para> </note> </para> <para> - Ve formátovacím øetìzci lze pou¾ívat tyto znaky: - <itemizedlist> - <listitem> - <simpara> - a - "am" nebo "pm" - </simpara> - </listitem> - <listitem> - <simpara> - A - "AM" nebo "PM" - </simpara> - </listitem> - <listitem> - <simpara> - B - internetový èas Swatch ("zavináèe") - </simpara> - </listitem> - <listitem> - <simpara> - d - den v mìsíci, 2 èíslice s úvodními nulami, "01" a¾ "31" - </simpara> - </listitem> - <listitem> - <simpara> - D - den v týdnu, textovì, 3 písmena, napø. "Fri" - </simpara> - </listitem> - <listitem> - <simpara> - F - mìsíc, textovì, dlouhý název, napø. "January" - </simpara> - </listitem> - <listitem> - <simpara> - g - hodina, 12-hodinový formát bez úvodních nul, "1" a¾ "12" - </simpara> - </listitem> - <listitem> - <simpara> - G - hodina, 24-hodinový formát bez úvodních nul, "0" a¾ "23" - </simpara> - </listitem> - <listitem> - <simpara> - h - hodina, 12-hodinový formát, "01" a¾ "12" - </simpara> - </listitem> - <listitem> - <simpara> - H - hodina, 24-hodinový formát, "00" a¾ "23" - </simpara> - </listitem> - <listitem> - <simpara> - i - minuty, "00" a¾ "59" - </simpara> - </listitem> - <listitem> - <simpara> - I (velké i) - "1" pro letní èas, jinak "0" - </simpara> - </listitem> - <listitem> - <simpara> - j - den v mìsíci bez úvodních nul, napø. "1" a¾ "31" - </simpara> - </listitem> - <listitem> - <simpara> - l (malé 'L') - den v týdnu, textovì, dlouhý název, napø. "Friday" - </simpara> - </listitem> - <listitem> - <simpara> - L - pravdivostní hodnota urèující, zda je pøestupný rok, "0" nebo "1" - </simpara> - </listitem> - <listitem> - <simpara> - m - mìsíc, "01" a¾ "12" - </simpara> - </listitem> - <listitem> - <simpara> - M - mìsíc, textovì, 3 písmena, napø. "Jan" - </simpara> - </listitem> - <listitem> - <simpara> - n - mìsíc bez úvodních nul, "1" a¾ "12" - </simpara> - </listitem> - <listitem> - <simpara> - O - odchylka od greenwichského èasu v hodinách, napø. "+0200" - </simpara> - </listitem> - <listitem> - <simpara> - r - datum formátované podle RFC 822, napø. - "Thu, 21 Dec 2000 16:01:07 +0200" (pøidáno v PHP 4.0.4) - </simpara> - </listitem> - <listitem> - <simpara> - s - sekundy, "00" a¾ "59" - </simpara> - </listitem> - <listitem> - <simpara> - S - anglická pøípona øadové èíslovky pro den v mìsíci, 2 znaky, - "st", "nd", "rd" nebo "th" - </simpara> - </listitem> - <listitem> - <simpara> - t - poèet dní v daném mìsíci, "28" a¾ "31" - </simpara> - </listitem> - <listitem> - <simpara> - T - èasová zóna nastavená na serveru, napø. "EST" nebo "MDT" - </simpara> - </listitem> - <listitem> - <simpara> - U - sekundy od Unix Epoch (1.1.1970 00:00:00 GMT) - </simpara> - </listitem> - <listitem> - <simpara> - w - den v týdnu, èíselnì, "0" (nedìle) a¾ "6" (sobota) - </simpara> - </listitem> - <listitem> - <simpara> - W - poèet týdnù v roce podle ISO-8601, týden zaèíná v pondìlí - (pøidáno v PHP 4.1.0) - </simpara> - </listitem> - <listitem> - <simpara> - Y - rok, 4 èíslice, napø. "1999" - </simpara> - </listitem> - <listitem> - <simpara> - y - rok, 2 èíslice, napø. "99" - </simpara> - </listitem> - <listitem> - <simpara> - z - den v roce, "0" a¾ "365" - </simpara> - </listitem> - <listitem> - <simpara> - Z - èasový posun v sekundách ("-43200" a¾ "43200"). Posun má pro èasové - zóny na západ od UTC zápornou hodnotu, na východ kladnou. - </simpara> - </listitem> - </itemizedlist> + <table> + <title>Ve formátovacím øetìzci lze pou¾ívat tyto + znaky:</title> + <tgroup cols="3"> + <thead> + <row> + <entry>znak parametru <parameter>format</parameter></entry> + <entry>Popis</entry> + <entry>Ukázka vracených hodnot</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>a</literal></entry> + <entry>Pøíznak dopoledne/odpoledne malými písmeny</entry> + <entry><literal>am</literal> nebo <literal>pm</literal></entry> + </row> + <row> + <entry><literal>A</literal></entry> + <entry>Pøíznak dopoledne/odpoledne velkými písmeny</entry> + <entry><literal>AM</literal> nebo <literal>PM</literal></entry> + </row> + <row> + <entry><literal>B</literal></entry> + <entry>Internetový èas Swatch</entry> + <entry><literal>000</literal> a¾ <literal>999</literal></entry> + </row> + <row> + <entry><literal>d</literal></entry> + <entry>Den mìsíce, dvì èíslice s úvodními nulami</entry> + <entry><literal>01</literal> a¾ <literal>31</literal></entry> + </row> + <row> + <entry><literal>D</literal></entry> + <entry>Textová reprezentace dne, tøi znaky</entry> + <entry><literal>Mon</literal> a¾ <literal>Sun</literal></entry> + </row> + <row> + <entry><literal>F</literal></entry> + <entry>Plná textová reprezentace mìsíce typu January nebo March</entry> + <entry><literal>January</literal> a¾ <literal>December</literal></entry> + </row> + <row> + <entry><literal>g</literal></entry> + <entry>12-hodinový formát hodiny bez úvodních nul</entry> + <entry><literal>1</literal> a¾ <literal>12</literal></entry> + </row> + <row> + <entry><literal>G</literal></entry> + <entry>24-hodinový formát hodiny bez úvodních nul</entry> + <entry><literal>0</literal> a¾ <literal>23</literal></entry> + </row> + <row> + <entry><literal>h</literal></entry> + <entry>12-hodinový formát hodiny s úvodními nulami</entry> + <entry><literal>01</literal> a¾ <literal>12</literal></entry> + </row> + <row> + <entry><literal>H</literal></entry> + <entry>24-hodinový formát hodiny s úvodními nulami</entry> + <entry><literal>00</literal> a¾ <literal>23</literal></entry> + </row> + <row> + <entry><literal>i</literal></entry> + <entry>Minuty s úvodními nulami</entry> + <entry><literal>00</literal> a¾ <literal>59</literal></entry> + </row> + <row> + <entry><literal>I</literal> (velké i)</entry> + <entry>Zji¹tìní, zda je letní èas</entry> + <entry><literal>1</literal> pokud je letní èas, <literal>0</literal> jinak.</entry> + </row> + <row> + <entry><literal>j</literal></entry> + <entry>Den mìsíce bez úvodních nul</entry> + <entry><literal>1</literal> a¾ <literal>31</literal></entry> + </row> + <row> + <entry><literal>l</literal> (malé 'L')</entry> + <entry>Plná textová reprezentace dne v týdnu</entry> + <entry><literal>Sunday</literal> a¾ <literal>Saturday</literal></entry> + </row> + <row> + <entry><literal>L</literal></entry> + <entry>Zji¹tìní, zda je rok pøestupný</entry> + <entry><literal>1</literal> pokud je pøestupný rok, <literal>0</literal> jinak.</entry> + </row> + <row> + <entry><literal>m</literal></entry> + <entry>Èíselná reprezentace mìsíce s úvodními nulami</entry> + <entry><literal>01</literal> a¾ <literal>12</literal></entry> + </row> + <row> + <entry><literal>M</literal></entry> + <entry>Krátká textová reprezentace mìsíce, tøi znaky</entry> + <entry><literal>Jan</literal> a¾ <literal>Dec</literal></entry> + </row> + <row> + <entry><literal>n</literal></entry> + <entry>Èíselná reprezentace mìsíce bez úvodních nul</entry> + <entry><literal>1</literal> a¾ <literal>12</literal></entry> + </row> + <row> + <entry><literal>O</literal></entry> + <entry>Odchylka od Greenwichského èasu (GMT) v hodinách</entry> + <entry>Pøíklad: <literal>+0200</literal></entry> + </row> + <row> + <entry><literal>r</literal></entry> + <entry>Datum formátované podle RFC 822</entry> + <entry>Pøíklad: <literal>Thu, 21 Dec 2000 16:01:07 +0200</literal></entry> + </row> + <row> + <entry><literal>s</literal></entry> + <entry>Sekundy s úvodními nulami</entry> + <entry><literal>00</literal> a¾ <literal>59</literal></entry> + </row> + <row> + <entry><literal>S</literal></entry> + <entry>Anglická poøadová pøípona dne v mìsíci, 2 znaky</entry> + <entry> + <literal>st</literal>, <literal>nd</literal>, <literal>rd</literal> nebo + <literal>th</literal>. Dobøe funguje s <literal>j</literal> + </entry> + </row> + <row> + <entry><literal>t</literal></entry> + <entry>Poèet dní v daném mìsíci</entry> + <entry><literal>28</literal> a¾ <literal>31</literal></entry> + </row> + <row> + <entry><literal>T</literal></entry> + <entry>Nastavení èasového pásma na tomto poèítaèi</entry> + <entry>Pøíklady: <literal>EST</literal>, <literal>MDT</literal> ...</entry> + </row> + <row> + <entry><literal>U</literal></entry> + <entry>Sekundy od poèátku éry Unix (1. ledna 1970 00:00:00 GMT)</entry> + <entry>Viz také <function>time</function></entry> + </row> + <row> + <entry><literal>w</literal></entry> + <entry>Èíselná reprezentace dne v týdnu</entry> + <entry><literal>0</literal> (pro nedìli) a¾ <literal>6</literal> (pro sobotu)</entry> + </row> + <row> + <entry><literal>W</literal></entry> + <entry>Èíslo týdne podle ISO-8601, týdny zaèínají v pondìlí (doplnìno v PHP 4.1.0)</entry> + <entry>Pøíklad: <literal>42</literal> (42. týden v roce)</entry> + </row> + <row> + <entry><literal>Y</literal></entry> + <entry>Plná èíselná reprezentace roku, 4 èíslice</entry> + <entry>Pøíklady: <literal>1999</literal> nebo <literal>2003</literal></entry> + </row> + <row> + <entry><literal>y</literal></entry> + <entry>Dvouciferná reprezentace roku</entry> + <entry>Pøíklady: <literal>99</literal> nebo <literal>03</literal></entry> + </row> + <row> + <entry><literal>z</literal></entry> + <entry>Den v roce</entry> + <entry><literal>0</literal> a¾ <literal>366</literal></entry> + </row> + <row> + <entry><literal>Z</literal></entry> + <entry>Posun èasového pásma v sekundách. Posun èasových pásem západnì od UTC je v¾dy + záporný, východnì od UTC je v¾dy kladný.</entry> + <entry><literal>-43200</literal> a¾ <literal>43200</literal></entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> Nerozpoznané znaky ve formátovacím øetìzci se vytiskou tak, jak jsou. - Pøi pou¾ití <function>gmdate</function> má formát "Z" v¾dy hodnotu 0. + Pøi pou¾ití <function>gmdate</function> má formát <literal>Z</literal> + v¾dy hodnotu <literal>0</literal>. </para> <para> <example> - <title>Pøíklad - <function>date</function></title> + <title>Pøíklady - <function>date</function></title> <programlisting role="php"> <![CDATA[ +<?php +// Vytiskne nìco jako: Wednesday +echo date("l"); + +// Vytiskne nìco jako: Wednesday 15th of January 2003 05:51:38 AM echo date ("l dS of F Y h:i:s A"); + +// Vytiskne: 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> @@ -219,7 +243,10 @@ <title>Ochrana znakù ve funkci <function>date</function></title> <programlisting role="php"> <![CDATA[ -echo date("l \\t\h\e jS"); // vytiskne nìco jako 'Saturday the 8th' +<?php +// vytiskne nìco jako 'Saturday the 8th' +echo date("l \\t\h\e jS"); +?> ]]> </programlisting> </example> @@ -232,9 +259,11 @@ </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> @@ -258,7 +287,8 @@ </title> <programlisting role="php"> <![CDATA[ -/* Dnes je 10. bøezna 2001, 5:16:18 odpoledne */ +<?php +// Pøedpokládejme, ¾e dnes je 10. bøezna 2001, 17:16:18 $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 @@ -268,6 +298,7 @@ $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> Index: phpdoc-cs/reference/datetime/functions/getdate.xml diff -u phpdoc-cs/reference/datetime/functions/getdate.xml:1.1 phpdoc-cs/reference/datetime/functions/getdate.xml:1.2 --- phpdoc-cs/reference/datetime/functions/getdate.xml:1.1 Sat Aug 10 19:37:15 2002 +++ phpdoc-cs/reference/datetime/functions/getdate.xml Mon Dec 8 10:12:58 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.8 Maintainer: luk Status: ready --> <refentry id="function.getdate"> <refnamediv> @@ -16,73 +16,121 @@ Vrací asociativní pole obsahující informaci o datu (èase) v argumentu <parameter>timestamp</parameter> nebo aktuální místní èas (pokud není argument pøítomen), jako tyto elementy: - <itemizedlist> - <listitem> - <simpara> - "seconds" - sekundy - </simpara> - </listitem> - <listitem> - <simpara> - "minutes" - minuty - </simpara> - </listitem> - <listitem> - <simpara> - "hours" - hodiny - </simpara> - </listitem> - <listitem> - <simpara> - "mday" - den v mìsíci - </simpara> - </listitem> - <listitem> - <simpara> - "wday" - den v týdnu, èíselnì: od 0 (nedìle) do 6 (sobota) - </simpara> - </listitem> - <listitem> - <simpara> - "mon" - mìsíc, èíselnì - </simpara> - </listitem> - <listitem> - <simpara> - "year" - rok, èíselnì - </simpara> - </listitem> - <listitem> - <simpara> - "yday" - den v roce, èíselnì; napø. "299" - </simpara> - </listitem> - <listitem> - <simpara> - "weekday" - den v týdnu, textovì, plný název; napø. "Friday" - </simpara> - </listitem> - <listitem> - <simpara> - "month" - mìsíc, textovì, plný název; napø. "January" - </simpara> - </listitem> - </itemizedlist> + </para> + <para> + <table> + <title>Klíèe vráceného asociativního pole</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Klíè</entry> + <entry>Popis</entry> + <entry>Ukázka vracených hodnot</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>"seconds"</literal></entry> + <entry>Èíselná reprezentace sekund</entry> + <entry><literal>0</literal> a¾ <literal>59</literal></entry> + </row> + <row> + <entry><literal>"minutes"</literal></entry> + <entry>Èíselná reprezentace minut</entry> + <entry><literal>0</literal> a¾ <literal>59</literal></entry> + </row> + <row> + <entry><literal>"hours"</literal></entry> + <entry>Èíselná reprezentace hodin</entry> + <entry><literal>0</literal> a¾ <literal>23</literal></entry> + </row> + <row> + <entry><literal>"mday"</literal></entry> + <entry>Èíselná reprezentace dne v mìsíci</entry> + <entry><literal>1</literal> a¾ <literal>31</literal></entry> + </row> + <row> + <entry><literal>"wday"</literal></entry> + <entry>Èíselná reprezentace dne v týdnu</entry> + <entry><literal>0</literal> (pro nedìli) a¾ <literal>6</literal> (pro sobotu)</entry> + </row> + <row> + <entry><literal>"mon"</literal></entry> + <entry>Èíselná reprezentace mìsíce</entry> + <entry><literal>1</literal> a¾ <literal>12</literal></entry> + </row> + <row> + <entry><literal>"year"</literal></entry> + <entry>Plná èíselná reprezentace roku, 4 èíslice</entry> + <entry>Pøíklady: <literal>1999</literal> nebo <literal>2003</literal></entry> + </row> + <row> + <entry><literal>"yday"</literal></entry> + <entry>Èíselná reprezentace dne v roce</entry> + <entry><literal>0</literal> a¾ <literal>366</literal></entry> + </row> + <row> + <entry><literal>"weekday"</literal></entry> + <entry>Plná textová reprezentace dne v týdnu</entry> + <entry><literal>Sunday</literal> a¾ <literal>Saturday</literal></entry> + </row> + <row> + <entry><literal>"month"</literal></entry> + <entry>Plná textová reprezentace mìsíce</entry> + <entry><literal>January</literal> a¾ <literal>December</literal></entry> + </row> + <row> + <entry><literal>0</literal></entry> + <entry>Sekundy éry Unixu, obdobnì jako hodnoty vracené funkcí + <function>time</function> a pou¾ívané funkcí <function>date</function>.</entry> + <entry>Závislé na systému, typicky <literal>-2147483648</literal> a¾ + <literal>2147483647</literal>.</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> <example> <title> Pøíklad - <function>getdate</function> </title> <programlisting role="php"> <![CDATA[ -$today = getdate(); -$month = $today['month']; -$mday = $today['mday']; -$year = $today['year']; -echo "$month $mday, $year"; +<?php +$today = getdate(); +print_r($today); +?> ]]> </programlisting> + <para> + Výstup bude vypadat zhruba takto: + </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> + Viz také <function>date</function>, + <function>time</function> a + <function>setlocale</function>. + </para> </refsect1> </refentry> Index: phpdoc-cs/reference/datetime/functions/gmdate.xml diff -u phpdoc-cs/reference/datetime/functions/gmdate.xml:1.1 phpdoc-cs/reference/datetime/functions/gmdate.xml:1.2 --- phpdoc-cs/reference/datetime/functions/gmdate.xml:1.1 Tue Sep 3 16:20:51 2002 +++ phpdoc-cs/reference/datetime/functions/gmdate.xml Mon Dec 8 10:12:58 2003 @@ -1,9 +1,9 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: luk Status: ready --> <refentry id="function.gmdate"> <refnamediv> <refname>gmdate</refname> - <refpurpose>Formátuje datum/èas GMT/CUT</refpurpose> + <refpurpose>Formátuje datum/èas GMT/UTC</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -21,12 +21,34 @@ <title>Pøíklad - <function>gmdate</function></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> + V operaèním systému Microsoft Windows jsou systémové + knihovny implementující tuto funkci po¹kozené, tak¾e + funkce <function>gmdate</function> nepodporuje negativní hodnoty + parametru <parameter>timestamp</parameter>. + Blí¾e viz bug-reporty: + <ulink url="&url.php.bugs;22620">#22620</ulink>, + <ulink url="&url.php.bugs;22457">#22457</ulink> + a <ulink url="&url.php.bugs;14391">#14391</ulink>. + </para> + <para> + K tomuto problému nedochází v operaèních systémech Unix/Linux, kde + se systémové knihovny chovají podle oèekávání. + </para> + <para> + PHP nemá moc opravit po¹kozené systémové knihovny. Kontaktujte + prodejce svého OS, aby tento a podobné problémy opravil. + </para> + </note> <para> Viz také <function>date</function>, <function>mktime</function>, <function>gmmktime</function> a <function>strftime</function>. Index: phpdoc-cs/reference/datetime/functions/gmmktime.xml diff -u phpdoc-cs/reference/datetime/functions/gmmktime.xml:1.1 phpdoc-cs/reference/datetime/functions/gmmktime.xml:1.2 --- phpdoc-cs/reference/datetime/functions/gmmktime.xml:1.1 Tue Sep 3 16:20:51 2002 +++ phpdoc-cs/reference/datetime/functions/gmmktime.xml Mon Dec 8 10:12:58 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: luk Status: ready --> <refentry id="function.gmmktime"> <refnamediv> <refname>gmmktime</refname> @@ -9,18 +9,23 @@ <title>Popis</title> <methodsynopsis> <type>int</type><methodname>gmmktime</methodname> - <methodparam><type>int</type><parameter>hour</parameter></methodparam> - <methodparam><type>int</type><parameter>minute</parameter></methodparam> - <methodparam><type>int</type><parameter>second</parameter></methodparam> - <methodparam><type>int</type><parameter>month</parameter></methodparam> - <methodparam><type>int</type><parameter>day</parameter></methodparam> - <methodparam><type>int</type><parameter>year</parameter></methodparam> + <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> Identické k <function>mktime</function>, kromì toho, ¾e parametry reprezentují datum/èas v GMT. </para> + <para> + Podobnì jako u funkce <function>mktime</function> mohou být parametry vynechány v poøadí + zprava doleva. Neuvedené parametry budou nastaveny + na odpovídající hodnotu souèasného GMT. + </para> </refsect1> </refentry> Index: phpdoc-cs/reference/datetime/functions/gmstrftime.xml diff -u phpdoc-cs/reference/datetime/functions/gmstrftime.xml:1.1 phpdoc-cs/reference/datetime/functions/gmstrftime.xml:1.2 --- phpdoc-cs/reference/datetime/functions/gmstrftime.xml:1.1 Tue Sep 3 16:20:51 2002 +++ phpdoc-cs/reference/datetime/functions/gmstrftime.xml Mon Dec 8 10:12:58 2003 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.3 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: luk Status: ready --> <refentry id="function.gmstrftime"> <refnamediv> <refname>gmstrftime</refname> <refpurpose> - Formátuje datum/èas v GMT/CUT vzhledem k národnímu nastavení + Formátuje datum/èas v GMT/UTC vzhledem k národnímu nastavení </refpurpose> </refnamediv> <refsect1> @@ -23,9 +23,11 @@ <title><function>gmstrftime</function> example</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> Index: phpdoc-cs/reference/datetime/functions/localtime.xml diff -u phpdoc-cs/reference/datetime/functions/localtime.xml:1.1 phpdoc-cs/reference/datetime/functions/localtime.xml:1.2 --- phpdoc-cs/reference/datetime/functions/localtime.xml:1.1 Tue Sep 3 16:20:51 2002 +++ phpdoc-cs/reference/datetime/functions/localtime.xml Mon Dec 8 10:12:58 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: luk Status: ready --> <refentry id="function.localtime"> <refnamediv> @@ -21,7 +21,8 @@ Funkce <function>localtime</function> vrací pole strukturálnì identické k návratové hodnotì volání v C. První argument funkce <function>localtime</function> je èasové razítko; není-li dáno, pou¾ije - se aktuální èas. Druhý argument <function>localtime</function> je + se aktuální èas, který vrátí funkce <function>time</function>. + Druhý argument <function>localtime</function> je <parameter>is_associative</parameter>, který (nastavením na nulu) signalizuje, ¾e vracené pole je obyèejné, èíselnì indexované pole. Je-li argument nastaven na 1, potom <function>localtime</function> Index: phpdoc-cs/reference/datetime/functions/microtime.xml diff -u phpdoc-cs/reference/datetime/functions/microtime.xml:1.1 phpdoc-cs/reference/datetime/functions/microtime.xml:1.2 --- phpdoc-cs/reference/datetime/functions/microtime.xml:1.1 Tue Sep 3 16:20:51 2002 +++ phpdoc-cs/reference/datetime/functions/microtime.xml Mon Dec 8 10:12:58 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: luk Status: ready --> <refentry id="function.microtime"> <refnamediv> @@ -25,6 +25,7 @@ <title>Pøíklad - <function>microtime</function></title> <programlisting role="php"> <![CDATA[ +<?php function getmicrotime(){ list($usec, $sec) = explode(" ",microtime()); return ((float)$usec + (float)$sec); @@ -40,6 +41,7 @@ $time = $time_end - $time_start; echo "Nic se nedìlalo $time sekund"; +?> ]]> </programlisting> </example> Index: phpdoc-cs/reference/datetime/functions/mktime.xml diff -u phpdoc-cs/reference/datetime/functions/mktime.xml:1.1 phpdoc-cs/reference/datetime/functions/mktime.xml:1.2 --- phpdoc-cs/reference/datetime/functions/mktime.xml:1.1 Tue Sep 3 16:20:51 2002 +++ phpdoc-cs/reference/datetime/functions/mktime.xml Mon Dec 8 10:12:58 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: luk Status: ready --> <refentry id="function.mktime"> <refnamediv> @@ -10,12 +10,12 @@ <title>Popis</title> <methodsynopsis> <type>int</type><methodname>mktime</methodname> - <methodparam><type>int</type><parameter>hour</parameter></methodparam> - <methodparam><type>int</type><parameter>minute</parameter></methodparam> - <methodparam><type>int</type><parameter>second</parameter></methodparam> - <methodparam><type>int</type><parameter>month</parameter></methodparam> - <methodparam><type>int</type><parameter>day</parameter></methodparam> - <methodparam><type>int</type><parameter>year</parameter></methodparam> + <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> @@ -54,10 +54,12 @@ <title>Pøíklad - <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> @@ -65,7 +67,17 @@ èíslicemi, s hodnotami 0-69 mapovanými na 2000-2069 a 70-99 na 1970-1999 (na systémech, kde time_t je 32bitové celé èíslo se znaménkem, jak je dnes obvyklé, budou platné hodnoty pro <parameter>year</parameter> - nìkde mezi 1902 a 2037). + nìkde mezi 1901 a 2038). + </para> + <para> + <note> + <title>Windows</title> + <simpara> + Záporné èasové znaèky nejsou podporovány v ¾ádné známé + verzi Windows. Platné rozmezí rokù je proto pouze 1970 + a¾ 2038. + </simpara> + </note> </para> <para> Poslední den daného mìsíce mù¾e být vyjádøen jako den "0" mìsíce pøí¹tího, @@ -75,11 +87,13 @@ <title>Poslední den mìsíce</title> <programlisting role="php"> <![CDATA[ +<?php $lastday = mktime (0,0,0,3,0,2000); echo strftime ("Last day in Feb 2000 is: %d", $lastday); $lastday = mktime (0,0,0,4,-31,2000); echo strftime ("Last day in Feb 2000 is: %d", $lastday); +?> ]]> </programlisting> </example> Index: phpdoc-cs/reference/datetime/functions/strftime.xml diff -u phpdoc-cs/reference/datetime/functions/strftime.xml:1.1 phpdoc-cs/reference/datetime/functions/strftime.xml:1.2 --- phpdoc-cs/reference/datetime/functions/strftime.xml:1.1 Thu Sep 26 16:22:18 2002 +++ phpdoc-cs/reference/datetime/functions/strftime.xml Mon Dec 8 10:12:58 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.10 Maintainer: luk Status: ready --> <refentry id="function.strftime"> <refnamediv> @@ -228,30 +228,100 @@ <para> V¹echny konverzní specifikátory nemusí být podporovány va¹í C knihovnou, potom nebudou podporovány ani funkcí <function>strftime</function> - v PHP. To znamená, ¾e %T a %D nebudou fungovat na Windows. + v PHP. Kromì toho také ne v¹echny platformy + podporují práci s negativními èasovými znaèkami, tak¾e rozsah mo¾ných datumù + mù¾e být omezen zaèátkem éry Unixu. To znamená, ¾e + napø. %e, %T, %R a %D (a pøípadnì i dal¹í) a datumy pøedcházející + <literal>1.1.1970</literal> nebudou fungovat pod Windows, nìkterými distribucemi + Linuxu a nìkolika dal¹ími operaèními systémy. Pro Windows lze + kompletní pøehled podporovaných konverzních specifikátorù najít na + <ulink url="&url.strftime.win32;">webových stránkách <acronym>MSDN</acronym></ulink>. + </para> </note> <example> - <title>Pøíklad - <function>strftime</function></title> + <title><function>strftime</function> - místní pøíklady</title> <programlisting role="php"> <![CDATA[ -setlocale (LC_TIME, "C"); -print (strftime ("%A je ve fin¹tinì ")); -setlocale (LC_TIME, "fi_FI"); -print (strftime ("%A, ve francouz¹tinì ")); -setlocale (LC_TIME, "fr_FR"); -print (strftime ("%A a v nìmèinì ")); -setlocale (LC_TIME, "de_DE"); -print (strftime ("%A.\n")); +<?php +setlocale(LC_TIME, "C"); +echo strftime("%A"); +setlocale(LC_TIME, "fi_FI"); +echo strftime(" je ve fin¹tinì %A,"); +setlocale(LC_TIME, "fr_FR"); +echo strftime(" ve francouz¹tinì %A a"); +setlocale(LC_TIME, "de_DE"); +echo strftime(" v nìmèinì %A.\n"); +?> ]]> </programlisting> </example> Tento pøíklad bude fungovat jen tehdy, máte-li daná národní specifika nainstalována v systému. + <note> + <simpara> + %G a %V, které jsou zalo¾eny na normì ISO 8601:1988, mohou + vrátit neoèekávané (a pøesto správné) výsledky, pokud nemáte v èíslovacím systému + zcela jasno. Viz %V vý¹e a pøíklad ní¾e. + </simpara> + </note> + <example> + <title>Pøíklad èísel týdnù podle ISO 8601:1988</title> + <programlisting role="php"> +<![CDATA[ +<?php +/* December 2002 / January 2003 +ISOWk M Tu W Thu F Sa Su +----- ---------------------------- +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 */ + +// Vypí¹e: 28.12.2002 - %V,%G,%Y = 52,2002,2002 +echo "28.12.2002 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/28/2002")) . "\n"; + +// Vypí¹e: 30.12.2002 - %V,%G,%Y = 1,2003,2002 +echo "30.12.2002 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/30/2002")) . "\n"; + +// Vypí¹e: 3.1.2003 - %V,%G,%Y = 1,2003,2003 +echo "3.1.2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2003")) . "\n"; + +// Vypí¹e: 10.1.2003 - %V,%G,%Y = 2,2003,2003 +echo "10.1.2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/10/2003")) . "\n"; + + + +/* December 2004 / January 2005 +ISOWk M Tu W Thu F Sa Su +----- ---------------------------- +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 */ + +// Vypí¹e: 23.12.2004 - %V,%G,%Y = 52,2004,2004 +echo "23.12.2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/23/2004")) . "\n"; + +// Vypí¹e: 31.12.2004 - %V,%G,%Y = 53,2004,2004 +echo "31.12.2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/31/2004")) . "\n"; + +// Vypí¹e: 2.1.2005 - %V,%G,%Y = 53,2004,2005 +echo "2.1.2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/2/2005")) . "\n"; + +// Vypí¹e: 3.1.2005 - %V,%G,%Y = 1,2005,2005 +echo "3.1.2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2005")) . "\n"; + +?> +]]> + </programlisting> + </example> </para> <para> - Viz také <function>setlocale</function> a - <function>mktime</function>, a <ulink url="&spec.strftime;"> + Viz také <function>setlocale</function>, + <function>mktime</function> a <ulink url="&spec.strftime;"> specifikaci Open Group <function>strftime</function></ulink>. </para> Index: phpdoc-cs/reference/bzip2/configure.xml +++ phpdoc-cs/reference/bzip2/configure.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- EN-Revision: 1.4 Maintainer: luk Status: ready --> <section id="bzip2.installation"> &reftitle.install; <para> Podpora bzip2 není v PHP implicitnì k dispozici. K aktivaci budete muset pøi kompilaci PHP pou¾ít konfiguraèní volbu <option role="configure">--with-bz2[=DIR]</option>. </para> </section> <!-- 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 -->