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