cvs: phpdoc-cs / language-snippets.ent /reference/datetime/functions strftime.xml

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:
 -->