leszek Fri Jun 14 22:01:42 2002 EDT
Added files:
/phpdoc-pl/reference/datetime/functions mktime.xml
Log:
[qrak] Datetime upload
Index: phpdoc-pl/reference/datetime/functions/mktime.xml
+++ phpdoc-pl/reference/datetime/functions/mktime.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.mktime">
<refnamediv>
<refname>mktime</refname>
<refpurpose>Oblicza uniksowy znacznik czasu dla podanej daty</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<methodsynopsis>
<type>int</type><methodname>mktime</methodname>
<methodparam><type>int</type><parameter>godzina</parameter></methodparam>
<methodparam><type>int</type><parameter>minuta</parameter></methodparam>
<methodparam><type>int</type><parameter>sekunda</parameter></methodparam>
<methodparam><type>int</type><parameter>miesi�c</parameter></methodparam>
<methodparam><type>int</type><parameter>dzie�</parameter></methodparam>
<methodparam><type>int</type><parameter>rok</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>letni/zimowy</parameter></methodparam>
</methodsynopsis>
<para>
<emphasis>Uwaga:</emphasis> Prosz� zwr�ci� uwag� na dziwn� kolejno��
argument�w, zupe�nie odmienn� od spotykanej w standardowym wywo�aniu
uniksowym mktime(); kt�ra w dodatku nie jest praktyczna przy opuszczaniu
argument�w
od prawej do lewej (patrz ni�ej). Cz�stym b��dem w skryptach s� pomy�ki
w kolejno�ci tych argument�w.
</para>
<para>
Funkcja zwraca uniksowy znacznik czasu odpowiadaj�cy podanym argumentom.
Znacznik czasu jest liczb� ca�kowit� d�ug� (long integer) zawieraj�c�
liczb� sekund dziel�c� uniksow� Epok� (1 stycznia 1970) od podanego
w argumentach czasu.
</para>
<para>
Argumenty mog� by� opuszczane w kolejno�ci od prawej do lewej. Za ka�dy
pomini�ty argument b�dzie w�wczas wstawiona aktualna warto��, zgodnie
z lokalnym czasem/dat�.
</para>
<para>
Argument <parameter>letni/zimowy</parameter> mo�e by� ustawiony na 1, je�li
to czas zimowy, lub 0 je�li letni, lub -1 (domy�lnie) je�li niewiadomo,
czy letni czy zimowy. Je�li niewiadomo, PHP spr�buje ustali� to
samodzielnie. Mo�e to powodowa� nieoczekiwane (ale na pewno poprawne)
wyniki.
</para>
<note>
<para>
Argument <parameter>letni/zimowy</parameter> dodano w PHP 3.0.10.
</para>
</note>
<para>
Funkcja <function>mktime</function> przydaje si� przy wykonywaniu
arytmetyki dat i walidacji, gdy� automatycznie policzy w�a�ciw� warto��
dla danych spoza przedzia��w. Na przyk�ad, ka�da poni�sza linia wy�wietli
"Jan-01-1998".
<example>
<title>przyk�ad <function>mktime</function></title>
<programlisting role="php">
<![CDATA[
echo date ("M-d-Y", mktime (0,0,0,12,32,1997));
echo date ("M-d-Y", mktime (0,0,0,13,1,1997));
echo date ("M-d-Y", mktime (0,0,0,1,1,1998));
echo date ("M-d-Y", mktime (0,0,0,1,1,98));
]]>
</programlisting>
</example>
<parameter>rok</parameter> mo�e by� liczb� dwu lub czterocyfrow�, przy
czym warto�ci dwucyfrowe z przedzia�u 0-69 b�d� mapowane do 2000-2069,
a z przedzia�u 70-99 do 1970-1999 (w systemach, w kt�rych time_t jest
32-bitow� liczb� ca�kowit� ze znakiem, co jest obecnie najpopularniejszym
rozwi�zaniem, poprawny zakres argumentu <parameter>rok</parameter>
zawiera si� pomi�dzy 1902 a 2037).
</para>
<para>
Ostatni dzie� dowolnego miesi�ca mo�e by� wyra�ony jako zerowy dzie�
nast�pnego miesi�ca, ale nie jako -1 dzie�. Obydwa poni�sze przyk�ady
wy�wietl� "Ostatni dzie� lutego 2000 to: 29".
<example>
<title>Ostatni dzie� miesi�ca</title>
<programlisting role="php">
<![CDATA[
$ostatni = mktime (0,0,0,3,0,2000);
echo strftime ("Ostatni dzie� lutego 2000 to: %d", $ostatni);
$ostatni = mktime (0,0,0,4,-31,2000);
echo strftime ("Ostatni dzie� lutego 2000 to: %d", $ostatni);
]]>
</programlisting>
</example>
</para>
<simpara>
Data z rokiem, miesi�cem i dniem r�wnym zero jest niepoprawna (w przeciwnym
razie oznacza�oby to 30.11.1999, co mog�oby powodowa� dziwne rezultaty).
</simpara>
<para>
Patrz tak�e <function>date</function> i <function>time</function>.
</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
-->
