cvs: phpdoc-cs / language-snippets.ent /reference/datetime/functions strftime.xml
| From: | Lukas Jelinek | Date: | Thu, 26 Sep 2002 20:22:18 +0000 |
| Subject: | cvs: phpdoc-cs / language-snippets.ent /reference/datetime/functions strftime.xml | ||
| Groups: | php.doc.cs | ||
| Request: | Send a blank email to doc-cs+get-18@lists.php.net to get a copy of this message | ||
luk Thu Sep 26 16:22:18 2002 EDT
Added files:
/phpdoc-cs/reference/datetime/functions strftime.xml
Modified files:
/phpdoc-cs language-snippets.ent
Log:
Index: phpdoc-cs/language-snippets.ent diff -u phpdoc-cs/language-snippets.ent:1.16 phpdoc-cs/language-snippets.ent:1.17 --- phpdoc-cs/language-snippets.ent:1.16 Sat Sep 21 06:17:28 2002 +++ phpdoc-cs/language-snippets.ent Thu Sep 26 16:22:18 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.28 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.31 Maintainer: luk Status: ready --> <!ENTITY warn.experimental '<warning><simpara>Toto roz¹íøení je <emphasis>EXPERIMENTÁLNÍ</emphasis>. Chování tohoto roz¹íøení, @@ -97,7 +97,7 @@ <!-- Used in reference/$extname/ini.xml --> <!ENTITY extension.runtime '<simpara> -The behaviour of these functions is affected by settings in &php.ini;. +Chování tìchto funkcí je ovlivnìno nastavením parametrù v &php.ini;. </simpara>'> <!-- Used in reference/$extname/constants.xml --> Index: phpdoc-cs/reference/datetime/functions/strftime.xml +++ phpdoc-cs/reference/datetime/functions/strftime.xml <?xml version="1.0" encoding="iso-8859-2"?> <!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> <refentry id="function.strftime"> <refnamediv> <refname>strftime</refname> <refpurpose> Formátuje místní èas/datum s ohledem na nastavení národních specifik </refpurpose> </refnamediv> <refsect1> <title>Popis</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> Vrací øetìzec formátovaný podle daného formátovacího øetìzce, s pou¾itím daného èasového razítka <parameter>timestamp</parameter>, nebo aktuálního místního èasu, není-li razítko dáno. Název mìsíce, dne v týdnu a dal¹í jazykovì závislé øetìzce respektují národní specifika nastavená pomocí <function>setlocale</function>. </para> <para> Ve formátovacím øetìzci se rozli¹ují tyto konverzní specifikátory: <itemizedlist> <listitem> <simpara> %a - zkrácený název dne v týdnu (podle národního nastavení) </simpara> </listitem> <listitem> <simpara> %A - úplný název dne v týdnu (podle národního nastavení) </simpara> </listitem> <listitem> <simpara> %b - zkrácený název mìsíce (podle národního nastavení) </simpara> </listitem> <listitem> <simpara> %B - úplný název mìsíce (podle národního nastavení) </simpara> </listitem> <listitem> <simpara> %c - reprezentace èasu a data preferovaná aktuálním národním nastavením </simpara> </listitem> <listitem> <simpara> %C - èíslo století (rok dìlený 100 a zkrácený na celé èíslo, od 00 do 99) </simpara> </listitem> <listitem> <simpara> %d - den v mìsíci jako desítkové èíslo (01 a¾ 31) </simpara> </listitem> <listitem> <simpara> %D - toté¾ jako %m/%d/%y </simpara> </listitem> <listitem> <simpara> %e - den v mìsíci jako desítkové èíslo, jedné samotné èíslici (èísla 1 a¾ 9) pøedchází mezera (' 1' a¾ '31') </simpara> </listitem> <listitem> <simpara> %g - jako %G, ale bez století </simpara> </listitem> <listitem> <simpara> %G - ètyøèíslicovì reprezentovaný rok odpovídající týdnu podle ISO (viz %V). Má tentý¾ formát a hodnotu jako %Y, kromì toho, ¾e pokud èíslo týdne podle ISO patøí pøedchozímu nebo následujícímu roku, bude tento odli¹ný rok pou¾it. </simpara> </listitem> <listitem> <simpara> %h - toté¾ jako %b </simpara> </listitem> <listitem> <simpara> %H - hodina jako desítkové èíslo ve 24-hodinovém formátu (00 a¾ 23) </simpara> </listitem> <listitem> <simpara> %I - hodina jako desítkové èíslo ve 12-hodinovém formátu (01 a¾ 12) </simpara> </listitem> <listitem> <simpara> %j - den v roce jako desítkové èíslo (001 a¾ 366) </simpara> </listitem> <listitem> <simpara> %m - mìsíc jako desítkové èíslo (01 a¾ 12) </simpara> </listitem> <listitem> <simpara> %M - minuta jako desítkové èíslo </simpara> </listitem> <listitem> <simpara> %n - znak odøádkování </simpara> </listitem> <listitem> <simpara> %p - `am' nebo `pm' v závislosti na hodnotì èasu, resp. odpovídající øetìzec podle národního nastavení </simpara> </listitem> <listitem> <simpara> %r - èas v notaci a.m. a p.m. (12-hodinové) </simpara> </listitem> <listitem> <simpara> %R - èas ve 24-hodinové notaci </simpara> </listitem> <listitem> <simpara> %S - sekunda jako desítkové èíslo </simpara> </listitem> <listitem> <simpara> %t - znak tabulátoru </simpara> </listitem> <listitem> <simpara> %T - aktuální èas, toté¾ jako %H:%M:%S </simpara> </listitem> <listitem> <simpara> %u - den v týdnu jako desítkové èíslo [1,7], 1 reprezentuje pondìlí </simpara> <warning> <simpara> Na poèítaèích Sun Solaris se vyskytuje nedìle jako první den v týdnu, pøesto¾e ISO 9889:1999 (aktuální C standard) jasnì specifikuje, ¾e by to mìlo být pondìlí. </simpara> </warning> </listitem> <listitem> <simpara> %U - týden v aktuálním roce jako desítkové èíslo, poèínaje první nedìlí jako prvním dnem prvního týdne </simpara> </listitem> <listitem> <simpara> %V - týden v aktuálním roce podle ISO 8601:1988 jako desítkové èíslo, v rozsahu od 01 do 53, kde 1 je první týden s alespoò 4 dny v tomto roce, a s pondìlkem jako prvním dnem v týdnu. (Odpovídající rok lze získat pomocí %G nebo %g.) </simpara> </listitem> <listitem> <simpara> %W - týden v aktuálním roce jako desítkové èíslo, poèínaje prvním pondìlkem jako prvním dnem prvního týdne </simpara> </listitem> <listitem> <simpara> %w - den v týdnu jako desítkové èíslo, nedìle odpovídá 0 </simpara> </listitem> <listitem> <simpara> %x - preferovaná reprezentace data (bez èasu) pro aktuální národní nastavení </simpara> </listitem> <listitem> <simpara> %X - preferovaná reprezentace èasu (bez data) pro aktuální národní nastavení </simpara> </listitem> <listitem> <simpara> %y - rok jako desítkové èíslo bez století (00 a¾ 99) </simpara> </listitem> <listitem> <simpara> %Y - rok jako desítkové èíslo vèetnì století </simpara> </listitem> <listitem> <simpara> %Z - èasová zóna, její název nebo zkratka </simpara> </listitem> <listitem> <simpara> %% - znak `%' (procento) </simpara> </listitem> </itemizedlist> <note> <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. </para> </note> <example> <title>Pøíklad - <function>strftime</function></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")); ]]> </programlisting> </example> Tento pøíklad bude fungovat jen tehdy, máte-li daná národní specifika nainstalována v systému. </para> <para> Viz také <function>setlocale</function> a <function>mktime</function>, a <ulink url="&spec.strftime;"> specifikaci Open Group <function>strftime</function></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: -->
Index: phpdoc-cs/language-snippets.ent diff -u phpdoc-cs/language-snippets.ent:1.16 phpdoc-cs/language-snippets.ent:1.17 --- phpdoc-cs/language-snippets.ent:1.16 Sat Sep 21 06:17:28 2002 +++ phpdoc-cs/language-snippets.ent Thu Sep 26 16:22:18 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.28 Maintainer: luk Status: ready --> +<!-- EN-Revision: 1.31 Maintainer: luk Status: ready --> <!ENTITY warn.experimental '<warning><simpara>Toto roz¹íøení je <emphasis>EXPERIMENTÁLNÍ</emphasis>. Chování tohoto roz¹íøení, @@ -97,7 +97,7 @@ <!-- Used in reference/$extname/ini.xml --> <!ENTITY extension.runtime '<simpara> -The behaviour of these functions is affected by settings in &php.ini;. +Chování tìchto funkcí je ovlivnìno nastavením parametrù v &php.ini;. </simpara>'> <!-- Used in reference/$extname/constants.xml --> Index: phpdoc-cs/reference/datetime/functions/strftime.xml +++ phpdoc-cs/reference/datetime/functions/strftime.xml <?xml version="1.0" encoding="iso-8859-2"?> <!-- EN-Revision: 1.2 Maintainer: luk Status: ready --> <refentry id="function.strftime"> <refnamediv> <refname>strftime</refname> <refpurpose> Formátuje místní èas/datum s ohledem na nastavení národních specifik </refpurpose> </refnamediv> <refsect1> <title>Popis</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> Vrací øetìzec formátovaný podle daného formátovacího øetìzce, s pou¾itím daného èasového razítka <parameter>timestamp</parameter>, nebo aktuálního místního èasu, není-li razítko dáno. Název mìsíce, dne v týdnu a dal¹í jazykovì závislé øetìzce respektují národní specifika nastavená pomocí <function>setlocale</function>. </para> <para> Ve formátovacím øetìzci se rozli¹ují tyto konverzní specifikátory: <itemizedlist> <listitem> <simpara> %a - zkrácený název dne v týdnu (podle národního nastavení) </simpara> </listitem> <listitem> <simpara> %A - úplný název dne v týdnu (podle národního nastavení) </simpara> </listitem> <listitem> <simpara> %b - zkrácený název mìsíce (podle národního nastavení) </simpara> </listitem> <listitem> <simpara> %B - úplný název mìsíce (podle národního nastavení) </simpara> </listitem> <listitem> <simpara> %c - reprezentace èasu a data preferovaná aktuálním národním nastavením </simpara> </listitem> <listitem> <simpara> %C - èíslo století (rok dìlený 100 a zkrácený na celé èíslo, od 00 do 99) </simpara> </listitem> <listitem> <simpara> %d - den v mìsíci jako desítkové èíslo (01 a¾ 31) </simpara> </listitem> <listitem> <simpara> %D - toté¾ jako %m/%d/%y </simpara> </listitem> <listitem> <simpara> %e - den v mìsíci jako desítkové èíslo, jedné samotné èíslici (èísla 1 a¾ 9) pøedchází mezera (' 1' a¾ '31') </simpara> </listitem> <listitem> <simpara> %g - jako %G, ale bez století </simpara> </listitem> <listitem> <simpara> %G - ètyøèíslicovì reprezentovaný rok odpovídající týdnu podle ISO (viz %V). Má tentý¾ formát a hodnotu jako %Y, kromì toho, ¾e pokud èíslo týdne podle ISO patøí pøedchozímu nebo následujícímu roku, bude tento odli¹ný rok pou¾it. </simpara> </listitem> <listitem> <simpara> %h - toté¾ jako %b </simpara> </listitem> <listitem> <simpara> %H - hodina jako desítkové èíslo ve 24-hodinovém formátu (00 a¾ 23) </simpara> </listitem> <listitem> <simpara> %I - hodina jako desítkové èíslo ve 12-hodinovém formátu (01 a¾ 12) </simpara> </listitem> <listitem> <simpara> %j - den v roce jako desítkové èíslo (001 a¾ 366) </simpara> </listitem> <listitem> <simpara> %m - mìsíc jako desítkové èíslo (01 a¾ 12) </simpara> </listitem> <listitem> <simpara> %M - minuta jako desítkové èíslo </simpara> </listitem> <listitem> <simpara> %n - znak odøádkování </simpara> </listitem> <listitem> <simpara> %p - `am' nebo `pm' v závislosti na hodnotì èasu, resp. odpovídající øetìzec podle národního nastavení </simpara> </listitem> <listitem> <simpara> %r - èas v notaci a.m. a p.m. (12-hodinové) </simpara> </listitem> <listitem> <simpara> %R - èas ve 24-hodinové notaci </simpara> </listitem> <listitem> <simpara> %S - sekunda jako desítkové èíslo </simpara> </listitem> <listitem> <simpara> %t - znak tabulátoru </simpara> </listitem> <listitem> <simpara> %T - aktuální èas, toté¾ jako %H:%M:%S </simpara> </listitem> <listitem> <simpara> %u - den v týdnu jako desítkové èíslo [1,7], 1 reprezentuje pondìlí </simpara> <warning> <simpara> Na poèítaèích Sun Solaris se vyskytuje nedìle jako první den v týdnu, pøesto¾e ISO 9889:1999 (aktuální C standard) jasnì specifikuje, ¾e by to mìlo být pondìlí. </simpara> </warning> </listitem> <listitem> <simpara> %U - týden v aktuálním roce jako desítkové èíslo, poèínaje první nedìlí jako prvním dnem prvního týdne </simpara> </listitem> <listitem> <simpara> %V - týden v aktuálním roce podle ISO 8601:1988 jako desítkové èíslo, v rozsahu od 01 do 53, kde 1 je první týden s alespoò 4 dny v tomto roce, a s pondìlkem jako prvním dnem v týdnu. (Odpovídající rok lze získat pomocí %G nebo %g.) </simpara> </listitem> <listitem> <simpara> %W - týden v aktuálním roce jako desítkové èíslo, poèínaje prvním pondìlkem jako prvním dnem prvního týdne </simpara> </listitem> <listitem> <simpara> %w - den v týdnu jako desítkové èíslo, nedìle odpovídá 0 </simpara> </listitem> <listitem> <simpara> %x - preferovaná reprezentace data (bez èasu) pro aktuální národní nastavení </simpara> </listitem> <listitem> <simpara> %X - preferovaná reprezentace èasu (bez data) pro aktuální národní nastavení </simpara> </listitem> <listitem> <simpara> %y - rok jako desítkové èíslo bez století (00 a¾ 99) </simpara> </listitem> <listitem> <simpara> %Y - rok jako desítkové èíslo vèetnì století </simpara> </listitem> <listitem> <simpara> %Z - èasová zóna, její název nebo zkratka </simpara> </listitem> <listitem> <simpara> %% - znak `%' (procento) </simpara> </listitem> </itemizedlist> <note> <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. </para> </note> <example> <title>Pøíklad - <function>strftime</function></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")); ]]> </programlisting> </example> Tento pøíklad bude fungovat jen tehdy, máte-li daná národní specifika nainstalována v systému. </para> <para> Viz také <function>setlocale</function> a <function>mktime</function>, a <ulink url="&spec.strftime;"> specifikaci Open Group <function>strftime</function></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: -->