cvs: phpdoc-pl /reference/datetime/functions strftime.xml
| From: | Leszek Krupinski | Date: | Sat, 15 Jun 2002 02:01:48 +0000 |
| Subject: | cvs: phpdoc-pl /reference/datetime/functions strftime.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969346480@lists.php.net to get a copy of this message | ||
leszek Fri Jun 14 22:01:48 2002 EDT
Added files:
/phpdoc-pl/reference/datetime/functions strftime.xml
Log:
[qrak] Datetime upload
Index: phpdoc-pl/reference/datetime/functions/strftime.xml +++ phpdoc-pl/reference/datetime/functions/strftime.xml <?xml version="1.0" encoding="iso-8859-2"?> <!-- EN-Revision: 1.1 Maintainer: Qrak Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.strftime"> <refnamediv> <refname>strftime</refname> <refpurpose> Formatuje lokaln± datê/czas zgodnie z lokalizacj± </refpurpose> </refnamediv> <refsect1> <title>Opis</title> <methodsynopsis> <type>string</type><methodname>strftime</methodname> <methodparam><type>string</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>znacznik_czasu</parameter></methodparam> </methodsynopsis> <para> Zwraca ³añcuch znaków sformatowany zgodnie z podanym szablonem formatuj±cym, przy u¿yciu podanego znacznika czasu lub aktualnego czasu, je¶li znacznik nie jest podany. Nazwy miesiêcy, dni tygodnia, itp. respektuj± ustawienia lokalizacji przy u¿yciu funkcji <function>setlocale</function>. </para> <para> Poni¿sze symbole s± rozpoznawane w szablonie formatuj±cym: <itemizedlist> <listitem> <simpara> %a - skrótowa nazwa dnia tygodnia zgodnie z lokalizacj± </simpara> </listitem> <listitem> <simpara> %A - pe³na nazwa dnia tygodnia zgodnie z lokalizacj± </simpara> </listitem> <listitem> <simpara> %b - skrótowa nazwa miesi±ca zgodnie z lokalizacj± </simpara> </listitem> <listitem> <simpara> %B - pe³na nazwa miesi±ca zgodnie z lokalizacj± </simpara> </listitem> <listitem> <simpara> %c - preferowana reprezentacja daty i czasu zgodnie z lokalizacj± </simpara> </listitem> <listitem> <simpara> %C - numer wieku (rok podzielony przez 100 i skrócony do liczby ca³kowitej, przedzia³ od 00 do 99) </simpara> </listitem> <listitem> <simpara> %d - dzieñ miesi±ca jako liczba dziesiêtna (przedzia³ od 01 do 31) </simpara> </listitem> <listitem> <simpara> %D - to samo co %m/%d/%y </simpara> </listitem> <listitem> <simpara> %e - dzieñ miesi±ca jako liczba dziesiêtna, przy czym pojedyncza cyfra poprzedzona jest spacj± (przedzia³ od " 1" do "31") </simpara> </listitem> <listitem> <simpara> %g - tak jak %G, ale bez uwzglêdnienia wieku </simpara> </listitem> <listitem> <simpara> %G - rok w zapisie czterocyfrowym, powi±zany z numerem tygodnia wg ISO. Symbol ten ma ten sam format i warto¶æ jak %Y, z tym wyj±tkiem, ¿e je¶li numer tygodnia wg ISO nale¿y do poprzedniego lub nastêpnego roku, to poprzedni lub nastêpny rok jest zwracany przez ten symbol. </simpara> </listitem> <listitem> <simpara> %h - tak jak %b </simpara> </listitem> <listitem> <simpara> %H - godzina jako liczba dziesiêtna w systemie 24-godzinnym (przedzia³ od 00 do 23) </simpara> </listitem> <listitem> <simpara> %I - godzina jako liczba dziesiêtna w systemie 12-godzinnym (przedzia³ od 01 do 12) </simpara> </listitem> <listitem> <simpara> %j - dzieñ roku jako liczba dziesiêtna (przedzia³ od 001 do 366) </simpara> </listitem> <listitem> <simpara> %m - miesi±c jako liczba dziesiêtna (przedzia³ od 01 do 12) </simpara> </listitem> <listitem> <simpara> %M - minuty jako liczba dziesiêtna </simpara> </listitem> <listitem> <simpara> %n - znak nowej linii </simpara> </listitem> <listitem> <simpara> %p - albo "am" lub "pm" zgodnie z podanym czasem, albo ³añcuchy znaków odpowiadaj±ce lokalizacji </simpara> </listitem> <listitem> <simpara> %r - czas w notacji a.m. lub p.m. </simpara> </listitem> <listitem> <simpara> %R - czas w notacji 24-godzinnej </simpara> </listitem> <listitem> <simpara> %S - sekundy jako liczba dziesiêtna </simpara> </listitem> <listitem> <simpara> %t - znak tabulacji </simpara> </listitem> <listitem> <simpara> %T - aktualny czas, odpowiednik %H:%M:%S </simpara> </listitem> <listitem> <simpara> %u - numer dnia tygodnia jako liczba dziesiêtna [1,7], gdzie 1 oznacza poniedzia³ek </simpara> <warning> <simpara> Sun Solaris podaje niedzielê jako 1, pomimo ¿e ISO 9889:1999 (aktualny standard jêzyka C) jasno okre¶la, ¿e powinien to byæ poniedzia³ek. </simpara> </warning> </listitem> <listitem> <simpara> %U - numer tygodnia aktualnego roku jako liczba dziesiêtna, pocz±wszy od pierwszej niedzieli jako pierwszego dnia pierwszego tygodnia </simpara> </listitem> <listitem> <simpara> %V - numer tygodnia aktualnego roku wg ISO 8601:1988 jako liczba dziesiêtna, przedzia³ od 01 do 53, gdzie tydzieñ 1 jest pierwszym tygodniem, którym ma co najmniej 4 dni w aktualnym roku, przy czym pierwszym dniem tygodnia jest poniedzia³ek. (Przy u¿yciu %G lub %g otrzymuje siê rok, który odpowiada numerowi tygodnia dla podanego znacznika czasu). </simpara> </listitem> <listitem> <simpara> %W - numer tygodnia aktualnego roku jako liczba dziesiêtna, pocz±wszy od pierwszego poniedzia³ku, jako pierwszego dnia pierwszego tygodnia </simpara> </listitem> <listitem> <simpara> %w - dzieñ tygodnia jako liczba dziesiêtna, pocz±wszy od niedzieli - numer 0 </simpara> </listitem> <listitem> <simpara> %x - preferowana reprezentacja daty, zgodnie z lokalizacj±, bez czasu </simpara> </listitem> <listitem> <simpara> %X - preferowana reprezentacja czasu, zgodnie z lokalizacj±, bez daty </simpara> </listitem> <listitem> <simpara> %y - rok jako liczba dziesiêtna, bez uwzglêdnienia wieku (przedzia³ od 00 do 99) </simpara> </listitem> <listitem> <simpara> %Y - rok jako liczba dziesiêtna, z wiekiem w³±cznie </simpara> </listitem> <listitem> <simpara> %Z - strefa czasowa, nazwa lub skrót </simpara> </listitem> <listitem> <simpara> %% - znak "%" </simpara> </listitem> </itemizedlist> <note> <para> Nie wszystkie symbole konwersji mog± byæ obs³ugiwane przez twoj± bibliotekê C, co oznacza, ¿e nie bêd± obs³ugiwane przez PHP-owsk± funkcjê <function>strftime</function>. Oznacza to, ¿e %T i %D nie bêd± funkcjonowaæ w Windows. </para> </note> <example> <title>przyk³ad <function>strftime</function></title> <programlisting role="php"> <![CDATA[ setlocale (LC_TIME, "C"); print (strftime ("%A, to w fiñskim ")); setlocale (LC_TIME, "fi_FI"); print (strftime ("%A, we francuskim ")); setlocale (LC_TIME, "fr_FR"); print (strftime ("%A, a w niemieckim ")); setlocale (LC_TIME, "de_DE"); print (strftime ("%A.\n")); ]]> </programlisting> </example> Powy¿szy przyk³ad dzia³a, je¶li masz zainstalowane w swoim systemie odpowiednie lokale. </para> <para> Patrz tak¿e <function>setlocale</function> i <function>mktime</function> oraz <ulink url="&spec.strftime;"> Otwarta Specyfikacja Grupowa <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: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
Index: phpdoc-pl/reference/datetime/functions/strftime.xml +++ phpdoc-pl/reference/datetime/functions/strftime.xml <?xml version="1.0" encoding="iso-8859-2"?> <!-- EN-Revision: 1.1 Maintainer: Qrak Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.strftime"> <refnamediv> <refname>strftime</refname> <refpurpose> Formatuje lokaln± datê/czas zgodnie z lokalizacj± </refpurpose> </refnamediv> <refsect1> <title>Opis</title> <methodsynopsis> <type>string</type><methodname>strftime</methodname> <methodparam><type>string</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>znacznik_czasu</parameter></methodparam> </methodsynopsis> <para> Zwraca ³añcuch znaków sformatowany zgodnie z podanym szablonem formatuj±cym, przy u¿yciu podanego znacznika czasu lub aktualnego czasu, je¶li znacznik nie jest podany. Nazwy miesiêcy, dni tygodnia, itp. respektuj± ustawienia lokalizacji przy u¿yciu funkcji <function>setlocale</function>. </para> <para> Poni¿sze symbole s± rozpoznawane w szablonie formatuj±cym: <itemizedlist> <listitem> <simpara> %a - skrótowa nazwa dnia tygodnia zgodnie z lokalizacj± </simpara> </listitem> <listitem> <simpara> %A - pe³na nazwa dnia tygodnia zgodnie z lokalizacj± </simpara> </listitem> <listitem> <simpara> %b - skrótowa nazwa miesi±ca zgodnie z lokalizacj± </simpara> </listitem> <listitem> <simpara> %B - pe³na nazwa miesi±ca zgodnie z lokalizacj± </simpara> </listitem> <listitem> <simpara> %c - preferowana reprezentacja daty i czasu zgodnie z lokalizacj± </simpara> </listitem> <listitem> <simpara> %C - numer wieku (rok podzielony przez 100 i skrócony do liczby ca³kowitej, przedzia³ od 00 do 99) </simpara> </listitem> <listitem> <simpara> %d - dzieñ miesi±ca jako liczba dziesiêtna (przedzia³ od 01 do 31) </simpara> </listitem> <listitem> <simpara> %D - to samo co %m/%d/%y </simpara> </listitem> <listitem> <simpara> %e - dzieñ miesi±ca jako liczba dziesiêtna, przy czym pojedyncza cyfra poprzedzona jest spacj± (przedzia³ od " 1" do "31") </simpara> </listitem> <listitem> <simpara> %g - tak jak %G, ale bez uwzglêdnienia wieku </simpara> </listitem> <listitem> <simpara> %G - rok w zapisie czterocyfrowym, powi±zany z numerem tygodnia wg ISO. Symbol ten ma ten sam format i warto¶æ jak %Y, z tym wyj±tkiem, ¿e je¶li numer tygodnia wg ISO nale¿y do poprzedniego lub nastêpnego roku, to poprzedni lub nastêpny rok jest zwracany przez ten symbol. </simpara> </listitem> <listitem> <simpara> %h - tak jak %b </simpara> </listitem> <listitem> <simpara> %H - godzina jako liczba dziesiêtna w systemie 24-godzinnym (przedzia³ od 00 do 23) </simpara> </listitem> <listitem> <simpara> %I - godzina jako liczba dziesiêtna w systemie 12-godzinnym (przedzia³ od 01 do 12) </simpara> </listitem> <listitem> <simpara> %j - dzieñ roku jako liczba dziesiêtna (przedzia³ od 001 do 366) </simpara> </listitem> <listitem> <simpara> %m - miesi±c jako liczba dziesiêtna (przedzia³ od 01 do 12) </simpara> </listitem> <listitem> <simpara> %M - minuty jako liczba dziesiêtna </simpara> </listitem> <listitem> <simpara> %n - znak nowej linii </simpara> </listitem> <listitem> <simpara> %p - albo "am" lub "pm" zgodnie z podanym czasem, albo ³añcuchy znaków odpowiadaj±ce lokalizacji </simpara> </listitem> <listitem> <simpara> %r - czas w notacji a.m. lub p.m. </simpara> </listitem> <listitem> <simpara> %R - czas w notacji 24-godzinnej </simpara> </listitem> <listitem> <simpara> %S - sekundy jako liczba dziesiêtna </simpara> </listitem> <listitem> <simpara> %t - znak tabulacji </simpara> </listitem> <listitem> <simpara> %T - aktualny czas, odpowiednik %H:%M:%S </simpara> </listitem> <listitem> <simpara> %u - numer dnia tygodnia jako liczba dziesiêtna [1,7], gdzie 1 oznacza poniedzia³ek </simpara> <warning> <simpara> Sun Solaris podaje niedzielê jako 1, pomimo ¿e ISO 9889:1999 (aktualny standard jêzyka C) jasno okre¶la, ¿e powinien to byæ poniedzia³ek. </simpara> </warning> </listitem> <listitem> <simpara> %U - numer tygodnia aktualnego roku jako liczba dziesiêtna, pocz±wszy od pierwszej niedzieli jako pierwszego dnia pierwszego tygodnia </simpara> </listitem> <listitem> <simpara> %V - numer tygodnia aktualnego roku wg ISO 8601:1988 jako liczba dziesiêtna, przedzia³ od 01 do 53, gdzie tydzieñ 1 jest pierwszym tygodniem, którym ma co najmniej 4 dni w aktualnym roku, przy czym pierwszym dniem tygodnia jest poniedzia³ek. (Przy u¿yciu %G lub %g otrzymuje siê rok, który odpowiada numerowi tygodnia dla podanego znacznika czasu). </simpara> </listitem> <listitem> <simpara> %W - numer tygodnia aktualnego roku jako liczba dziesiêtna, pocz±wszy od pierwszego poniedzia³ku, jako pierwszego dnia pierwszego tygodnia </simpara> </listitem> <listitem> <simpara> %w - dzieñ tygodnia jako liczba dziesiêtna, pocz±wszy od niedzieli - numer 0 </simpara> </listitem> <listitem> <simpara> %x - preferowana reprezentacja daty, zgodnie z lokalizacj±, bez czasu </simpara> </listitem> <listitem> <simpara> %X - preferowana reprezentacja czasu, zgodnie z lokalizacj±, bez daty </simpara> </listitem> <listitem> <simpara> %y - rok jako liczba dziesiêtna, bez uwzglêdnienia wieku (przedzia³ od 00 do 99) </simpara> </listitem> <listitem> <simpara> %Y - rok jako liczba dziesiêtna, z wiekiem w³±cznie </simpara> </listitem> <listitem> <simpara> %Z - strefa czasowa, nazwa lub skrót </simpara> </listitem> <listitem> <simpara> %% - znak "%" </simpara> </listitem> </itemizedlist> <note> <para> Nie wszystkie symbole konwersji mog± byæ obs³ugiwane przez twoj± bibliotekê C, co oznacza, ¿e nie bêd± obs³ugiwane przez PHP-owsk± funkcjê <function>strftime</function>. Oznacza to, ¿e %T i %D nie bêd± funkcjonowaæ w Windows. </para> </note> <example> <title>przyk³ad <function>strftime</function></title> <programlisting role="php"> <![CDATA[ setlocale (LC_TIME, "C"); print (strftime ("%A, to w fiñskim ")); setlocale (LC_TIME, "fi_FI"); print (strftime ("%A, we francuskim ")); setlocale (LC_TIME, "fr_FR"); print (strftime ("%A, a w niemieckim ")); setlocale (LC_TIME, "de_DE"); print (strftime ("%A.\n")); ]]> </programlisting> </example> Powy¿szy przyk³ad dzia³a, je¶li masz zainstalowane w swoim systemie odpowiednie lokale. </para> <para> Patrz tak¿e <function>setlocale</function> i <function>mktime</function> oraz <ulink url="&spec.strftime;"> Otwarta Specyfikacja Grupowa <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: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->