leszek Fri Jun 14 21:59:51 2002 EDT
Added files:
/phpdoc-pl/reference/datetime/functions date.xml
Log:
[qrak] Datetime upload
Index: phpdoc-pl/reference/datetime/functions/date.xml
+++ phpdoc-pl/reference/datetime/functions/date.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.2 Maintainer: Qrak Status: ready -->
<!-- $Revision: 1.1 $ -->
<!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 -->
<refentry id="function.date">
<refnamediv>
<refname>date</refname>
<refpurpose>Formatuje lokalny czas/dat�</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<methodsynopsis>
<type>string</type><methodname>date</methodname>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>
znacznik_czasu
</parameter></methodparam>
</methodsynopsis>
<para>
Zwraca dat� sformatowan� wed�ug szablonu podanego w argumencie
<parameter>format</parameter>. ��dana data okre�lona jest w argumencie
<parameter>znacznik_czasu</parameter>, a w przypadku jego braku pobierany
jest aktualny czas.
<note>
<para>
Poprawny zakres znacznika czasu to zwykle od pi�tku, 13 grudnia 1901
20:45:54 GMT (czasu Greenwich) do wtorku, 19 stycznia 2038 03:14:07 GMT.
(Warto�ci te odpowiadaj� minimalnej i maksymalnej warto�ci 32-bitowej
liczbie ca�kowitej ze znakiem). W systemie Windows zakres ten jest
bardziej ograniczony i zawiera si� w przedziale 01-01-1970 do 19-01-2038.
</para>
<para>
Wygenerowanie znacznika czasu z daty zapisanej jako �a�cuch znak�w
umo�liwia funkcja <function>strtotime</function>. R�wnie� niekt�re
systemy baz danych maj� funkcje konwersji ich format�w daty w
uniksowy znacznik czasu (jak np. funkcja UNIX_TIMESTAMP w MySQL-u).
</para>
</note>
</para>
<para>
Poni�szych znak�w u�ywa si� w szablonie formatuj�cym dat�:
<itemizedlist>
<listitem>
<simpara>
a - "am" lub "pm"
</simpara>
</listitem>
<listitem>
<simpara>
A - "AM" lub "PM"
</simpara>
</listitem>
<listitem>
<simpara>
B - Czas internetowy Swatcha
</simpara>
</listitem>
<listitem>
<simpara>
d - dzie� miesi�ca, 2 cyfry z zerem na pocz�tku; tzn. od "01"
do "31"
</simpara>
</listitem>
<listitem>
<simpara>
D - dzie� tygodnia, tekst, 3 litery; n.p. "Fri"
</simpara>
</listitem>
<listitem>
<simpara>
F - miesi�c, tekst, pe�na nazwa; n.p. "January"
</simpara>
</listitem>
<listitem>
<simpara>
g - godzina, format 12-godzinny bez zera na pocz�tku; tzn. od "1" do
"12"
</simpara>
</listitem>
<listitem>
<simpara>
G - godzina, format 24-godzinny bez zera na pocz�tku; tzn. od "0" do
"23"
</simpara>
</listitem>
<listitem>
<simpara>
h - godzina, format 12-godzinny z zerem na pocz�tku; tzn. od "01" do "12"
</simpara>
</listitem>
<listitem>
<simpara>
H - godzina, format 24-godzinny z zerem na pocz�tku; tzn. od "00" do "23"
</simpara>
</listitem>
<listitem>
<simpara>
i - minuty; tzn. od "00" do "59"
</simpara>
</listitem>
<listitem>
<simpara>
I (du�a litera i) - "1" je�li czas zimowy, "0" je�li czas letni.
</simpara>
</listitem>
<listitem>
<simpara>
j - dzie� miesi�ca bez zera na pocz�tku; tzn. od "1" do "31"
</simpara>
</listitem>
<listitem>
<simpara>
l (ma�a litera 'L') - dzie� tygodnia, tekst, pe�na nazwa;
n.p. "Friday"
</simpara>
</listitem>
<listitem>
<simpara>
L - "1" je�li rok przest�pny, "0" w przeciwnym razie
</simpara>
</listitem>
<listitem>
<simpara>
m - miesi�c; tzn. "01" to "12"
</simpara>
</listitem>
<listitem>
<simpara>
M - miesi�c, tekst, 3 litery; n.p. "Jan"
</simpara>
</listitem>
<listitem>
<simpara>
n - miesi�c bez zera na pocz�tku; tzn. "1" to "12"
</simpara>
</listitem>
<listitem>
<simpara>
O - r�nica w stosunku do czasu Greenwich; n.p. "+0200"
</simpara>
</listitem>
<listitem>
<simpara>
r - data sformatowana wed�ug RFC 822; n.p.
"Thu, 21 Dec 2000 16:01:07 +0200" (dodane w PHP 4.0.4)
</simpara>
</listitem>
<listitem>
<simpara>
s - sekundy; i.e. "00" to "59"
</simpara>
</listitem>
<listitem>
<simpara>
S - standardowy angielski sufiks liczebnika porz�dkowego, 2 litery;
tzn. "st", "nd", "rd" lub "th"
</simpara>
</listitem>
<listitem>
<simpara>
t - liczba dni w danym miesi�cu; tzn. od "28" do "31"
</simpara>
</listitem>
<listitem>
<simpara>
T - strefa czasowa ustawiona na tej maszynie; n.p. "EST" lub "MDT"
</simpara>
</listitem>
<listitem>
<simpara>
U - liczba sekund od uniksowej Epoki (1 stycznia 1970 00:00:00 GMT)
</simpara>
</listitem>
<listitem>
<simpara>
w - dzie� tygodnia, liczbowy, tzn. od "0" (Niedziela) do "6"
(Sobota)
</simpara>
</listitem>
<listitem>
<simpara>
W - numer tygodnia w roku wed�ug ISO-8601, tydzie� zaczyna si�
w poniedzia�ek (dodane w PHP 4.1.0)
</simpara>
</listitem>
<listitem>
<simpara>
Y - rok, 4 liczby; n.p. "1999"
</simpara>
</listitem>
<listitem>
<simpara>
y - rok, 2 liczby; n.p. "99"
</simpara>
</listitem>
<listitem>
<simpara>
z - dzie� roku; tzn. od "0" do "365"
</simpara>
</listitem>
<listitem>
<simpara>
Z - ofset strefy czasowej w sekundach (tzn. pomi�dzy "-43200" a
"43200"). Ofset dla stref czasowych na zach�d od UTC (po�udnika zero)
jest zawsze ujemny a dla tych na wsch�d od UTC jest zawsze dodatni.
</simpara>
</listitem>
</itemizedlist>
Nierozpoznane znaki w szablonie formatuj�cym b�d� wy�wietlone tak jak s�.
"Z" zawsze zwr�ci "0" kiedy u�ywana jest funkcja
<function>gmdate</function>.
</para>
<para>
<example>
<title>przyk�ady u�ycia <function>date</function></title>
<programlisting role="php">
<![CDATA[
echo date ("l dS of F Y h:i:s A");
echo "July 1, 2000 is on a " . date ("l", mktime(0,0,0,7,1,2000));
]]>
</programlisting>
</example>
</para>
<para>
Je�li nie chcesz, aby kt�ry� z rozpoznawalnych w szablonie znak�w zosta�
zast�piony odpowiadaj�c� mu cz�ci� daty, musisz poprzedzi� go znakiem
odwrotnego uko�nika (backslash). Je�li znak razem z odwrotnym uko�nikiem
tworzy jaki� znak specjalny, musisz r�wnie� zacytowa� uko�nik odwrotny.
<example>
<title>Opuszczanie znak�w w szablonie <function>date</function></title>
<programlisting role="php">
<![CDATA[
echo date("l \\t\h\e jS"); // wy�wietla tekst typu 'Saturday the 8th'
]]>
</programlisting>
</example>
</para>
<para>
Mo�na u�y� <function>date</function> i <function>mktime</function> razem,
aby odszuka� daty w przysz�o�ci lub przesz�o�ci.
<example>
<title>
przyk�ady zastosowania
<function>date</function> i <function>mktime</function></title>
<programlisting role="php">
<![CDATA[
$jutro = mktime (0,0,0,date("m") ,date("d")+1,date("Y"));
$ostatni_miesiac = mktime (0,0,0,date("m")-1,date("d"), date("Y"));
$kolejny_rok = mktime (0,0,0,date("m"), date("d"), date("Y")+1);
]]>
</programlisting>
</example>
<note>
<para>
Rozwi�zanie to jest bardziej godne zaufania od dodawania lub odejmowania
okre�lonej liczby sekund, chocia�by z powodu zmiany czasu.
</para>
</note>
</para>
<para>
Poni�ej znajduje si� kilka przyk�ad�w zastosowania
<function>date</function>. Prosz� zwr�ci� uwag�, �e powinno si� cytowa�
wszystkie znaki aby unikn�� nieoczekiwanych rezultat�w, a poza tym, nawet
te znaki, kt�re obecnie nie maj� znaczenia, mog� mie� przypisane jakie�
znaczenie w przysz�ych wersjach PHP. O ile to mo�liwe, nale�y u�ywa�
cudzys�ow�w pojedynczych, �eby unikn�� np. zamiany \n na znak nowej linii.
<example>
<title>
zastosowania <function>date</function>
</title>
<programlisting role="php">
<![CDATA[
/* Dzisiaj jest March 10th, 2001, 5:16:18 pm */
$today = date("F j, Y, g:i a"); // March 10, 2001, 5:16 pm
$today = date("m.d.y"); // 03.10.01
$today = date("j, n, Y"); // 10, 3, 2001
$today = date("Ymd"); // 20010310
$today = date('h-i-s, j-m-y, it is w Day z '); // 05-16-17, 10-03-01, 1631 1618 6
Fripm01
$today = date('\i\t \i\s \t\h\e jS \d\a\y.'); // It is the 10th day.
$today = date("D M j G:i:s T Y"); // Sat Mar 10 15:16:08 MST 2001
$today = date('H:m:s \m \i\s\ \m\o\n\t\h'); // 17:03:17 m is month
$today = date("H:i:s"); // 17:16:17
]]>
</programlisting>
</example>
</para>
<para>
Aby sformatowa� dat� w innych j�zykach, nale�y u�y� funkcji
<function>setlocale</function> i <function>strftime</function>.
</para>
<para>
Patrz tak�e <function>getlastmod</function>, <function>gmdate</function>,
<function>mktime</function>, <function>strftime</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
-->
