cvs: phpdoc-pl /reference/datetime/functions date.xml

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