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