cvs: phpdoc-de /reference/datetime/functions date.xml getdate.xml gmdate.xml gmstrftime.xml microtime.xml mktime.xml strftime.xml strtotime.xml
| From: | Friedhelm Betz | Date: | Fri, 21 Mar 2003 17:43:32 +0000 |
| Subject: | cvs: phpdoc-de /reference/datetime/functions date.xml getdate.xml gmdate.xml gmstrftime.xml microtime.xml mktime.xml strftime.xml strtotime.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-567@lists.php.net to get a copy of this message | ||
betz Fri Mar 21 12:43:32 2003 EDT
Modified files:
/phpdoc-de/reference/datetime/functions date.xml getdate.xml
gmdate.xml gmstrftime.xml
microtime.xml mktime.xml
strftime.xml strtotime.xml
Log:
sync to en
Index: phpdoc-de/reference/datetime/functions/date.xml diff -u phpdoc-de/reference/datetime/functions/date.xml:1.6 phpdoc-de/reference/datetime/functions/date.xml:1.7 --- phpdoc-de/reference/datetime/functions/date.xml:1.6 Sun Dec 1 16:22:00 2002 +++ phpdoc-de/reference/datetime/functions/date.xml Fri Mar 21 12:43:32 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: betz Status: ready --> <refentry id="function.date"> <refnamediv> @@ -17,8 +17,10 @@ <para> Gibt einen formatierten String anhand eines vorzugebenden Musters zurück. Dabei wird entweder der angegebene - <parameter>Timestamp</parameter> oder die gegenwärtige lokale - Zeit berücksichtigt, wenn kein Timestamp angegegeben wird. + <parameter>Timestamp</parameter> oder die gegenwärtige lokale Zeit berücksichtigt, + wenn kein Timestamp angegegeben wird. Mit anderen Worten ausgedrückt: der Parameter + <parameter>Timestamp</parameter> ist optional und falls dieser nicht angegeben wird, + wird der Wert der Funktion <function>time</function> angenommen. </para> <note> <para> @@ -32,184 +34,209 @@ Um einen Timestamp aus aus einem Datums-String zu erzeugen, können Sie die Funktion <function>strtotime</function> benutzen. Zusätzlich bieten einige Datenbanken Funktionen, um Ihre Datumsfromate in Timestamps - umzuwandeln (wie z.B. die MySQL-Funktion UNIX_TIMESTAMP). + umzuwandeln (wie zum Beispiel MySQL's + <ulink url="&url.mysql.docs.date;">UNIX_TIMESTAMP</ulink> Funktion. </para> </note> <para> - Die folgenden Zeichen werden bei der Formatierung erkannt: - <itemizedlist> - <listitem> - <simpara> - a - "am" oder "pm" - </simpara> - </listitem> - <listitem> - <simpara> - A - "AM" oder "PM" - </simpara> - </listitem> - <listitem> - <simpara> - B - Swatch-Internet-Zeit - </simpara> - </listitem> - <listitem> - <simpara> - d - Tag des Monats, 2-stellig mit führender Null: "01" bis "31" - </simpara> - </listitem> - <listitem> - <simpara> - D - Tag der Woche als 3 Buchstaben, z.B. "Fri" - </simpara> - </listitem> - <listitem> - <simpara> - F - Monat als ganzes Wort, z.B "January" - </simpara> - </listitem> - <listitem> - <simpara> - g - Stunde im 12-Stunden-Format, ohne führende Null: "1" bis "12" - </simpara> - </listitem> - <listitem> - <simpara> - G - Stunde im 24-Stunden-Format, ohne führende Null: "0" bis "23" - </simpara> - </listitem> - <listitem> - <simpara> - h - Stunde im 12-Stunden-Format: "01" bis "12" - </simpara> - </listitem> - <listitem> - <simpara> - H - Stunde im 24-Stunden-Format: "00" bis "23" - </simpara> - </listitem> - <listitem> - <simpara> - i - Minuten: "00" bis "59" - </simpara> - </listitem> - <listitem> - <simpara> - I (großes 'i') - "1" bei Sommerzeit, sonst "0" - </simpara> - </listitem> - <listitem> - <simpara> - j - Tag des Monats ohne führende Null: "1" bis "31" - </simpara> - </listitem> - <listitem> - <simpara> - l - (kleines 'L') ausgeschriebener Tag der Woche, z.B. "Friday" - </simpara> - </listitem> - <listitem> - <simpara> - L - boolscher Wert für Schaltjahre: "0" oder "1" - </simpara> - </listitem> - <listitem> - <simpara> - m - Monat: "01" to "12" - </simpara> - </listitem> - <listitem> - <simpara> - M - Monat als 3 Buchstaben, z.B. "Jan" - </simpara> - </listitem> - <listitem> - <simpara> - n - Monat ohne führende Null: "1" bis "12" - </simpara> - </listitem> - <listitem> - <simpara> - O - Zeitdifferenz zur Greenwich Zeit in Stunden (z.B. +0200) - </simpara> - </listitem> - <listitem> - <simpara> - r - Nach RFC 822 formatiertes Datum; z.B.: - "Sun, 7 Oct 2001 14:56:02 +0200" (seit PHP 4.0.4) - </simpara> - </listitem> - <listitem> - <simpara> - s - Sekunden: "00" bis "59" - </simpara> - </listitem> - <listitem> - <simpara> - S - Anhang der englischen Aufzählung, 2 Buchstaben; z.B.:" - "st", "nd", "rd" oder "th" - </simpara> - </listitem> - <listitem> - <simpara> - t - Anzahl der Tage des angegebenen Monats: "28" bis "31" - </simpara> - </listitem> - <listitem> - <simpara> - T - Zeitzoneneinstellung des Rechners, z.B. "EST" oder "MDT" - </simpara> - </listitem> - <listitem> - <simpara> - U - Sekunden seit Beginn der UNIX-Epoche (January 1 1970 00:00:00 GMT) - </simpara> - </listitem> - <listitem> - <simpara> - w - Wochentag numerisch, beginnend mit "0" (Sonntag) bis "6" (Samstag) - </simpara> - </listitem> - <listitem> - <simpara> - W - ISO-8601 Wochennummer des Jahres (Woche beginnt mit Montag) - (seit PHP 4.1.0) - </simpara> - </listitem> - <listitem> - <simpara> - y - Jahr als zweistellige Zahl, z.B. "99" - </simpara> - </listitem> - <listitem> - <simpara> - Y - Jahr als vierstellige Zahl, z.B. "1999" - </simpara> - </listitem> - <listitem> - <simpara> - z - Tag des Jahres: "0" bis "365" - </simpara> - </listitem> - <listitem> - <simpara> - Z - Offset der Zeitzone gegen GTM ("-43200" bis "43200") in - Sekunden. Der Offset für Zeitzone West nach UTC ist immer negativ - und für Zeitzone Ost nach UTC immer positiv. - </simpara> - </listitem> - </itemizedlist> - Nicht erkannte Zeichen werden unverändert ausgegeben. Das - "Z"-Format gibt beim Gebrauch von <function>gmdate</function> immer - "0" zurück. + <table> + <title> + Die folgenden Zeichen werden im Parameter <parameter>Format</parameter>erkannt + </title> + <tgroup cols="3"> + <thead> + <row> + <entry><parameter>Format</parameter> Zeichen</entry> + <entry>Beschreibung</entry> + <entry>Beispiel für Rückgabewerte</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>a</literal></entry> + <entry>Kleingeschrieben: Ante meridiem und Post meridiem</entry> + <entry><literal>am</literal> oder <literal>pm</literal></entry> + </row> + <row> + <entry><literal>A</literal></entry> + <entry>Großgeschrieben: Ante meridiem und Post meridiem</entry> + <entry><literal>AM</literal> oder <literal>PM</literal></entry> + </row> + <row> + <entry><literal>B</literal></entry> + <entry>Swatch-Internet-Zeit</entry> + <entry><literal>000</literal> bis <literal>999</literal></entry> + </row> + <row> + <entry><literal>d</literal></entry> + <entry>Tag des Monats, 2-stellig mit führender Null</entry> + <entry><literal>01</literal> bis <literal>31</literal></entry> + </row> + <row> + <entry><literal>D</literal></entry> + <entry>Tag der Woche als mit drei Buchstaben</entry> + <entry><literal>Mon</literal> bis <literal>Sun</literal></entry> + </row> + <row> + <entry><literal>F</literal></entry> + <entry>Monat als ganzes Wort, wie January oder March</entry> + <entry><literal>January</literal> bis <literal>December</literal></entry> + </row> + <row> + <entry><literal>g</literal></entry> + <entry>12-Stunden-Format, ohne führende Nullen</entry> + <entry><literal>1</literal> bis <literal>12</literal></entry> + </row> + <row> + <entry><literal>G</literal></entry> + <entry>24-Stunden-Format, ohne führende Nullen</entry> + <entry><literal>0</literal> bis <literal>23</literal></entry> + </row> + <row> + <entry><literal>h</literal></entry> + <entry>12-Stunden-Format, mit führenden Nullen</entry> + <entry><literal>01</literal> bis <literal>12</literal></entry> + </row> + <row> + <entry><literal>H</literal></entry> + <entry>24-Stunden-Format, mit führenden Nullen</entry> + <entry><literal>00</literal> bis <literal>23</literal></entry> + </row> + <row> + <entry><literal>i</literal></entry> + <entry>Minuten mit führenden Nullen</entry> + <entry><literal>00</literal> bis <literal>59</literal></entry> + </row> + <row> + <entry><literal>I</literal> (großes i)</entry> + <entry>Fällt ein Datum in die Sommerzeit</entry> + <entry><literal>1</literal> bei Sommerzeit, ansonsten <literal>0</literal>.</entry> + </row> + <row> + <entry><literal>j</literal></entry> + <entry>Tag des Monats ohne führende Nullen</entry> + <entry><literal>1</literal> bis <literal>31</literal></entry> + </row> + <row> + <entry><literal>l</literal> (kleines 'L')</entry> + <entry>Ausgeschriebener Tag der Woche</entry> + <entry><literal>Sunday</literal> bis <literal>Saturday</literal></entry> + </row> + <row> + <entry><literal>L</literal></entry> + <entry>Schaltjahr oder nicht</entry> + <entry><literal>1</literal> für ein Schaltjahr, ansonsten <literal>0</literal>.</entry> + </row> + <row> + <entry><literal>m</literal></entry> + <entry>Monat als Zahl, mit führenden Nullen</entry> + <entry><literal>01</literal> bis <literal>12</literal></entry> + </row> + <row> + <entry><literal>M</literal></entry> + <entry>Monatsname mit drei Buchstaben</entry> + <entry><literal>Jan</literal> bis <literal>Dec</literal></entry> + </row> + <row> + <entry><literal>n</literal></entry> + <entry>Monatszahl, ohne führende Nullen</entry> + <entry><literal>1</literal> bis <literal>12</literal></entry> + </row> + <row> + <entry><literal>O</literal></entry> + <entry>Zeitunterschied zur Greenwich time (GMT) in Stunden</entry> + <entry>Beispiel: <literal>+0200</literal></entry> + </row> + <row> + <entry><literal>r</literal></entry> + <entry>RFC 822 formatiertes Datume</entry> + <entry>Beispiel: <literal>Thu, 21 Dec 2000 16:01:07 +0200</literal></entry> + </row> + <row> + <entry><literal>s</literal></entry> + <entry>Sekunden, mit führenden Nullen</entry> + <entry><literal>00</literal> bis <literal>59</literal></entry> + </row> + <row> + <entry><literal>S</literal></entry> + <entry>Anhang der englischen Aufzählung für einen Monatstag, zwei Zeichen</entry> + <entry> + <literal>st</literal>, <literal>nd</literal>, <literal>rd</literal> oder + <literal>th</literal>. Zur Verwendung mit <literal>j</literal> empfohlen. + </entry> + </row> + <row> + <entry><literal>t</literal></entry> + <entry>Anzahl der Tage des angegebenen Monats</entry> + <entry><literal>28</literal> bis <literal>31</literal></entry> + </row> + <row> + <entry><literal>T</literal></entry> + <entry>Zeitzoneneinstellung des Rechners</entry> + <entry>Beispiele: <literal>EST</literal>, <literal>MDT</literal> ...</entry> + </row> + <row> + <entry><literal>U</literal></entry> + <entry> Sekunden seit Beginn der UNIX-Epoche (January 1 1970 00:00:00 GMT)</entry> + <entry>Siehe auch <function>time</function></entry> + </row> + <row> + <entry><literal>w</literal></entry> + <entry>Numerischer Tag einer Woche</entry> + <entry><literal>0</literal> (für Sonntag) bis <literal>6</literal> (für Samstag)</entry> + </row> + <row> + <entry><literal>W</literal></entry> + <entry>ISO-8601 Wochennummer des Jahres, die Woche beginnt am Montag (hinzugefügt in PHP 4.1.0)</entry> + <entry>Beispiel: <literal>42</literal> (die 42 Woche im Jahr)</entry> + </row> + <row> + <entry><literal>Y</literal></entry> + <entry>Vierstellige Jahreszahl</entry> + <entry>Beispiel: <literal>1999</literal> oder <literal>2003</literal></entry> + </row> + <row> + <entry><literal>y</literal></entry> + <entry>Jahreszahl, zweistellig</entry> + <entry>Beispiele: <literal>99</literal> oder <literal>03</literal></entry> + </row> + <row> + <entry><literal>z</literal></entry> + <entry>Der Tag eines Jahres</entry> + <entry><literal>0</literal> bis <literal>366</literal></entry> + </row> + <row> + <entry><literal>Z</literal></entry> + <entry> + Offset der Zeitzone in Sekunden. Der Offset für Zeitzone West nach + UTC ist immer negativ und für Zeitzone Ost nach UTC immer positiv. + </entry> + <entry><literal>-43200</literal> bis <literal>43200</literal></entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Nicht erkannte Zeichen werden unverändert ausgegeben. Das <literal>Z</literal> + Format gibt beim Gebrauch von <function>gmdate</function> immer + <literal>0</literal> zurück. </para> <para> <example> <title><function>date</function> Beispiel</title> <programlisting role="php"> <![CDATA[ -print (date("l dS of F Y h:i:s A")); -print ("July 1, 2000 is on a " . date ("l", mktime(0,0,0,7,1,2000))); +<?php +// Gibt etwas ähnliches zu Wednesday aus +echo date("l"); + +// Gibt etwas ähnliches aus wie: Wednesday 15th of January 2003 05:51:38 AM +echo date ("l dS of F Y h:i:s A"); + +// Ausgabe: July 1, 2000 ist ein Samstag +echo "July 1, 2000 ist ein " . date ("l", mktime(0,0,0,7,1,2000)); +?> ]]> </programlisting> </example> @@ -223,7 +250,8 @@ <title>Escaping von Zeichen in <function>date</function></title> <programlisting role="php"> <![CDATA[ -echo date("l \\t\h\e jS"); // gibt etwas ähnliches aus wie 'Saturday the 8th' + // gibt etwas ähnliches aus wie 'Wednesday the 15th' +echo date("l \\t\h\e jS"); ]]> </programlisting> </example> @@ -231,7 +259,7 @@ <para> Es ist möglich, <function>date</function> und <function>mktime</function> gleichzeitig zu verwenden, um - Datumsangaben der Zukunft/Vergangenheit herauszufinden. + Datumsangaben in der Zukunft/Vergangenheit zu bestimmen. <example> <title> <function>date</function> und <function>mktime</function> @@ -239,16 +267,18 @@ </title> <programlisting role="php"> <![CDATA[ +<?php $morgen = mktime(0, 0, 0, date("m"), date ("d")+1, date("Y")); $letztermonat = mktime(0, 0, 0, date("m")-1, date("d"), date("Y")); $naechstesjahr = mktime(0, 0, 0, date("m"), date("d"), date("Y")+1); +?> ]]> </programlisting> </example> <note> <para> Dieses Vorgehen kann zu verlässlicheren Ergebnissen führen, als simples - Addieren oder Subtrahieren der Anzahl von Sekunden in Tagen oder Monaten + addieren oder subtrahieren der Anzahl von Sekunden in Tagen oder Monaten zu einem Timestamp, da Sommer- und Winterzeit berücksichtigt werden. </para> </note> @@ -268,7 +298,9 @@ </title> <programlisting role="php"> <![CDATA[ -/* Today is March 10th, 2001, 5:16:18 pm */ +<?php +// Angenommen heute ist 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 @@ -278,22 +310,24 @@ $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> Um Datumsangaben in anderen Sprach-/Zeitzonen-Formaten - auszugeben, sollten sie die Funktionen - <function>setlocale</function> und <function>strftime</function> + auszugeben, sollten sie die Funktionen <function>setlocale</function> + und <function>strftime</function> benutzen. nutzen. </para> <para> - Siehe auch: <function>getlastmod</function>, - <function>gmdate</function>, - <function>mktime</function>, - <function>strftime</function> - und <function>time</function>. + Siehe auch + <function>getlastmod</function>, + <function>gmdate</function>, + <function>mktime</function>, + <function>strftime</function> + und <function>time</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/datetime/functions/getdate.xml diff -u phpdoc-de/reference/datetime/functions/getdate.xml:1.4 phpdoc-de/reference/datetime/functions/getdate.xml:1.5 --- phpdoc-de/reference/datetime/functions/getdate.xml:1.4 Sun Jun 9 06:55:30 2002 +++ phpdoc-de/reference/datetime/functions/getdate.xml Fri Mar 21 12:43:32 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.getdate"> <refnamediv> @@ -16,60 +16,77 @@ <para> Gibt ein assoziatives Array mit Datums- und Zeitangaben des angegebenen <parameter>Timestamp</parameter> zurück. Wird kein Timestamp - angegeben, wird die lokal gültige Zeit berücksichtigt. Die Arrayelemente - sind folgende: - <itemizedlist> - <listitem> - <simpara> - "seconds" - Sekunden - </simpara> - </listitem> - <listitem> - <simpara> - "minutes" - Minuten - </simpara> - </listitem> - <listitem> - <simpara> - "hours" - Stunden - </simpara> - </listitem> - <listitem> - <simpara> - "mday" - Tag des Monats - </simpara> - </listitem> - <listitem> - <simpara> - "wday" - numerischer Tag der Woche: von 0 als Sonntag bis 6 als Samstag - </simpara> - </listitem> - <listitem> - <simpara> - "mon" - Monat als Zahl - </simpara> - </listitem> - <listitem> - <simpara> - "year" - Jahr als Zahl - </simpara> - </listitem> - <listitem> - <simpara> - "yday" - Tag des Jahres als Zahlwert, z.B. "299" - </simpara> - </listitem> - <listitem> - <simpara> - "weekday" - ausgeschriebener Wochentag, z.B. "Friday" - </simpara> - </listitem> - <listitem> - <simpara> - "month" - ausgeschriebener Monatsname, z.B. "January" - </simpara> - </listitem> - </itemizedlist> + angegeben, wird die lokal gültige Zeit berücksichtigt. Die assoziativen + Arrayelemente sind folgende: + </para> + <para> + <table> + <title>The following characters are recognized in the + <parameter>format</parameter> parameter string</title> + <tgroup cols=""> + <thead> + <row> + <entry>Key</entry> + <entry>Beschreibung</entry> + <entry>Beispiel für Rückgabewerte</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>"seconds"</literal></entry> + <entry>Anzahl der Sekunden</entry> + <entry>zwischen <literal>0</literal> und <literal>59</literal></entry> + </row> + <row> + <entry><literal>"minutes"</literal></entry> + <entry>Anzahl der Minuten</entry> + <entry>zwischen <literal>0</literal> und <literal>59</literal></entry> + </row> + <row> + <entry><literal>"hours"</literal></entry> + <entry>Anzahl der Stunden</entry> + <entry>zwischen <literal>0</literal> und <literal>23</literal></entry> + </row> + <row> + <entry><literal>"mday"</literal></entry> + <entry>Numersicher Tag des Monats</entry> + <entry>zwischen <literal>1</literal> und <literal>31</literal></entry> + </row> + <row> + <entry><literal>"wday"</literal></entry> + <entry>Numerischer Wochentag</entry> + <entry>zwischen <literal>0</literal> (für Sonntag) und <literal>6</literal> (für Samstag)</entry> + </row> + <row> + <entry><literal>"mon"</literal></entry> + <entry>Monatszahl</entry> + <entry>zwischen <literal>1</literal> und <literal>12</literal></entry> + </row> + <row> + <entry><literal>"year"</literal></entry> + <entry>Vierstellige Jahreszahl</entry> + <entry>Beispiele: <literal>1999</literal> oder <literal>2003</literal></entry> + </row> + <row> + <entry><literal>"yday"</literal></entry> + <entry>Numerischer Tag des Jahres</entry> + <entry>zwischen <literal>0</literal> und <literal>366</literal></entry> + </row> + <row> + <entry><literal>"weekday"</literal></entry> + <entry>Ausgeschriebener Wochentag</entry> + <entry>zwischen <literal>Sonntag</literal> und <literal>Samstag</literal></entry> + </row> + <row> + <entry><literal>"month"</literal></entry> + <entry>Ausgeschriebener Monatsname, wie Januar oder März</entry> + <entry>zwischen<literal>Januar></literal> und <literal>Dezember</literal></entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> <example> <title> <function>getdate</function> Beispiel @@ -79,7 +96,7 @@ $heute = getdate(); $monat = $heute['month']; $tag_monat = $heute['mday']; -$Jahr = $heute['year']; +$jahr = $heute['year']; echo "$monat $tag_monat, $jahr"; ]]> </programlisting> Index: phpdoc-de/reference/datetime/functions/gmdate.xml diff -u phpdoc-de/reference/datetime/functions/gmdate.xml:1.6 phpdoc-de/reference/datetime/functions/gmdate.xml:1.7 --- phpdoc-de/reference/datetime/functions/gmdate.xml:1.6 Sun Dec 1 16:22:00 2002 +++ phpdoc-de/reference/datetime/functions/gmdate.xml Fri Mar 21 12:43:32 2003 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.6 Maintainer: betz Status: ready --> <refentry id="function.gmdate"> <refnamediv> <refname>gmdate</refname> - <refpurpose>Formatiert eine GMT/CUT Zeit- Datumsangabe</refpurpose> + <refpurpose>Formatiert eine GMT/UTC Zeit- Datumsangabe</refpurpose> </refnamediv> <refsect1> <title>Beschreibung:</title> @@ -24,17 +24,41 @@ <title><function>gmdate</function> Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php echo date ("M d Y H:i:s", mktime (0,0,0,1,1,1998)); echo gmdate("M d Y H:i:s", mktime (0,0,0,1,1,1998)); +?> ]]> </programlisting> </example> </para> + <note> + <para> + Bei den Microsoft Betriebssystemen ist die Systembibliothek, die diese + Funktionalität zur Verfügung stellt, defekt. Das hat zur Folge, dass + <function>gmdate</function> keine negativen Werte für den + <parameter>Timestamp</parameter> unterstützt.Weitere Details können Sie + folgenden Bugreports entnehmen: + <ulink url="&url.php.bugs;22620">#22620</ulink>, + <ulink url="&url.php.bugs;22457">#22457</ulink> + und <ulink url="&url.php.bugs;14391">#14391</ulink>. + </para> + <para> + Bei Unix/Linux Systemen ist dieses Problem nicht vorhanden. Hier funkfionieren + die Systembibliotheken wie erwartet. + </para> + <para> + PHP kann keine defekten Systembibliotheken reparieren. Kontaktieren Sie den + Verkaüfer Ihres Betriebssystems und bitten Sie um Reparatur für dieses und + ähnliche Probleme. + </para> + </note> <para> - Siehe auch: <function>date</function>, - <function>mktime</function>, - <function>gmmktime</function> und - <function>strftime</function>. + Siehe auch + <function>date</function>, + <function>mktime</function>, + <function>gmmktime</function> und + <function>strftime</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/datetime/functions/gmstrftime.xml diff -u phpdoc-de/reference/datetime/functions/gmstrftime.xml:1.4 phpdoc-de/reference/datetime/functions/gmstrftime.xml:1.5 --- phpdoc-de/reference/datetime/functions/gmstrftime.xml:1.4 Sun Jun 9 06:55:30 2002 +++ phpdoc-de/reference/datetime/functions/gmstrftime.xml Fri Mar 21 12:43:32 2003 @@ -1,12 +1,12 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: betz Status: ready --> <refentry id="function.gmstrftime"> <refnamediv> <refname>gmstrftime</refname> <refpurpose> - Formatiert eine Datum-/Zeitangabe in GMT/CUT-Format entsprechend den + Formatiert eine Datum-/Zeitangabe in GMT/UTC-Format entsprechend den lokalen Einstellungen </refpurpose> </refnamediv> @@ -27,9 +27,11 @@ <title><function>gmstrftime</function> Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php setlocale (LC_TIME, 'de_DE'); echo strftime ("%b %d %Y %H:%M:%S", mktime(0,0,0,12,31,98))."\n"; echo gmstrftime ("%b %d %Y %H:%M:%S", mktime(0,0,0,12,31,98))."\n"; +?> ]]> </programlisting> </example> Index: phpdoc-de/reference/datetime/functions/microtime.xml diff -u phpdoc-de/reference/datetime/functions/microtime.xml:1.4 phpdoc-de/reference/datetime/functions/microtime.xml:1.5 --- phpdoc-de/reference/datetime/functions/microtime.xml:1.4 Sun Jun 9 06:55:30 2002 +++ phpdoc-de/reference/datetime/functions/microtime.xml Fri Mar 21 12:43:32 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.microtime"> <refnamediv> @@ -29,6 +29,7 @@ <title><function>microtime</function> Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php function getmicrotime(){ list($usec, $sec) = explode(" ",microtime()); return ((float)$usec + (float)$sec); @@ -44,6 +45,7 @@ $time = $time_end - $time_start; echo "Nichts getan in $time Sekunden"; +?> ]]> </programlisting> </example> Index: phpdoc-de/reference/datetime/functions/mktime.xml diff -u phpdoc-de/reference/datetime/functions/mktime.xml:1.6 phpdoc-de/reference/datetime/functions/mktime.xml:1.7 --- phpdoc-de/reference/datetime/functions/mktime.xml:1.6 Sun Dec 1 16:22:00 2002 +++ phpdoc-de/reference/datetime/functions/mktime.xml Fri Mar 21 12:43:32 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.mktime"> <refnamediv> @@ -35,16 +35,16 @@ </para> <para> Einzelne Argumente können von rechts nach links weggelassen - werden. Sie werden dann ersetzt mit den Werten der lokalen - Systemzeit bzw. des lokalen Systemdatums. + werden. Sie werden dann mit den Werten der lokalen Systemzeit bzw. + des lokalen Systemdatums ersetzt. </para> <para> <parameter>is_dst</parameter> kann bei Sommerzeit auf 1 gesetzt werden. 0 bedeutet Winter-/Normalzeit, -1 (Vorgabewert) heißt, dass nicht bekannt ist, ob Sommer- oder Winterzeit - herrscht. Falls nicht bekannt ist (-1), ob Sommer- oder Winterzeit + herrscht. Falls nicht bekannt ist, ob Sommer- oder Winterzeit herrscht, versucht PHP selbst dies herauszufinden. Das kann zu - unerwarteten (aber richtigen) Ergebnissen führen. + unerwarteten (aber dennoch korrekten) Ergebnissen führen. </para> <note> <para> @@ -60,18 +60,31 @@ <title><function>mktime</function> Beispiel</title> <programlisting> <![CDATA[ +<?php 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> Das <parameter>Jahr</parameter> darf zwei- oder vierstellig angegeben werden. Werte von 0 bis 69 stehen dann für die Jahre 2000 bis 2069, und 70 bis 99 für die Jahre von 1970-1999 (auf Systemen, - die time_t als 32Bit-Integer abbilden, liegt der gültige Bereich - für <parameter>Jahr</parameter> zwischen 1902 und 2037). + die time_t als 32Bit-Integer abbilden, was heutzutage gebräuchlich ist, liegt + der gültige Bereich für den Parameter <parameter>Jahr</parameter> irgendwo + zwischen 1901 und 2038). + </para> + <para> + <note> + <title>Windows</title> + <simpara> + Negative Timestampwerte werden von keiner uns bekannten Windowsversion + unterstützt. Aus diesem Grund ist der Gültigkeitsbereich für Jahresangaben + auf Werte zwischen 1970 und 2038 eingeschränkt. + </simpara> + </note> </para> <para> Der letzte Tag eines gegebenen Monats kann als der Tag "0" des @@ -81,11 +94,15 @@ <example> <title>Letzter Tag des nächsten Monats</title> <programlisting> +<![CDATA[ +<?php $lastday = mktime (0,0,0,3,0,2000); echo strftime ("Letzter Tag im Feb. 2000 ist der %d.", $lastday); $lastday = mktime(0,0,0,4,-31,2000); echo strftime ("Letzter Tag im Feb. 2000 ist der %d.", $lastday); +?> +]]> </programlisting> </example> </para> Index: phpdoc-de/reference/datetime/functions/strftime.xml diff -u phpdoc-de/reference/datetime/functions/strftime.xml:1.9 phpdoc-de/reference/datetime/functions/strftime.xml:1.10 --- phpdoc-de/reference/datetime/functions/strftime.xml:1.9 Fri Dec 13 19:04:28 2002 +++ phpdoc-de/reference/datetime/functions/strftime.xml Fri Mar 21 12:43:32 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.6 Maintainer: betz Status: ready --> <refentry id="function.strftime"> <refnamediv> @@ -238,13 +238,15 @@ Es ist durchaus möglich, dass Ihre C-Bibliothek nicht alle angegebenen Formatierungszeichen erkennt. In diesem Fall werden diese Zeichen von der PHP-Funktion <function>strftime</function> nicht unterstützt. Das - bedeutet, dass z.B. %e, %T, %R und %D (vielleicht noch weitere) auf + bedeutet, dass z.B. %e, %T, %R und %D (und vielleicht noch weitere) auf Windowssystemen nicht funktionieren. </para> </note> <example> - <title><function>strftime</function> Beispiel</title> + <title><function>strftime</function> locale Beispiel</title> <programlisting role="php"> +<![CDATA[ +<?php setlocale (LC_TIME, "C"); print (strftime ("%A in Finnland ist ")); setlocale (LC_TIME, "fi_FI"); @@ -253,11 +255,74 @@ print (strftime ("%A und in Deutschland ")); setlocale (LC_TIME, "de_DE"); print (strftime ("%A.\n")); +?> +]]> </programlisting> </example> - Diese Beispiele funktionieren nur, wenn auf Ihrem System die entsprechenden - Locale-Codes installiert sind. - </para> + Dieses Beispiel funktioniert nur, wenn auf Ihrem System die entsprechenden + Locale-Codes installiert sind. + <note> + <simpara> + %G und %V basieren auf ISO 8601:1988 Wochennummern und können unerwartete + (obwohl korrekte) Ergebnisse liefern, wenn Sie das Nummernsystem nicht + gründlich verstehen. Sehen Sie weiter oben bei %V nach und beachten Sie die + folgenden Beispiele. + </simpara> + </note> + <example> + <title>ISO 8601:1988 Wochennummer Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php +/* December 2002 / January 2003 +ISOWk M Tu W Thu F Sa Su +----- ---------------------------- +51 16 17 18 19 20 21 22 +52 23 24 25 26 27 28 29 +1 30 31 1 2 3 4 5 +2 6 7 8 9 10 11 12 +3 13 14 15 16 17 18 19 */ + +// Ausgabe: 12/28/2002 - %V,%G,%Y = 52,2002,2002 +print "12/28/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/28/2002")) . "\n"; + +// Ausgabe: 12/30/2002 - %V,%G,%Y = 1,2003,2002 +print "12/30/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/30/2002")) . "\n"; + +// Ausgabe: 1/3/2003 - %V,%G,%Y = 1,2003,2003 +print "1/3/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2003")) . "\n"; + +// Ausgabe: 1/10/2003 - %V,%G,%Y = 2,2003,2003 +print "1/10/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/10/2003")) . "\n"; + + + +/* December 2004 / January 2005 +ISOWk M Tu W Thu F Sa Su +----- ---------------------------- +51 13 14 15 16 17 18 19 +52 20 21 22 23 24 25 26 +53 27 28 29 30 31 1 2 +1 3 4 5 6 7 8 9 +2 10 11 12 13 14 15 16 */ + +// Ausgabe: 12/23/2004 - %V,%G,%Y = 52,2004,2004 +print "12/23/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/23/2004")) . "\n"; + +// Ausgabe: 12/31/2004 - %V,%G,%Y = 53,2004,2004 +print "12/31/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/31/2004")) . "\n"; + +// Ausgabe: 1/2/2005 - %V,%G,%Y = 53,2004,2005 +print "1/2/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/2/2005")) . "\n"; + +// Ausgabe: 1/3/2005 - %V,%G,%Y = 1,2005,2005 +print "1/3/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2005")) . "\n"; + +?> +]]> + </programlisting> + </example> + </para> <para> Siehe auch <function>setlocale</function>, <function>mktime</function> und die <ulink url="&spec.strftime;"> Index: phpdoc-de/reference/datetime/functions/strtotime.xml diff -u phpdoc-de/reference/datetime/functions/strtotime.xml:1.6 phpdoc-de/reference/datetime/functions/strtotime.xml:1.7 --- phpdoc-de/reference/datetime/functions/strtotime.xml:1.6 Sun Dec 1 16:22:00 2002 +++ phpdoc-de/reference/datetime/functions/strtotime.xml Fri Mar 21 12:43:32 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.strtotime"> <refnamediv> @@ -36,6 +36,7 @@ <title><function>strtotime</function>-Beispiele:</title> <programlisting role="php"> <![CDATA[ +<?php echo strtotime ("now"), "\n"; echo strtotime ("10 September 2000"), "\n"; echo strtotime ("+1 day"), "\n"; @@ -43,6 +44,7 @@ echo strtotime ("+1 week 2 days 4 hours 2 seconds"), "\n"; echo strtotime ("next Thursday"), "\n"; echo strtotime ("last Monday"), "\n"; +?> ]]> </programlisting> </example> @@ -52,12 +54,14 @@ <title>Fehlerüberprüfung</title> <programlisting role="php"> <![CDATA[ +<?php $str = 'Nicht gut'; if (($timestamp = strtotime($str)) === -1) { echo "Der String ($str) ist falsch."; } else { echo "$str == ". date('l dS of F Y h:i:s A',$timestamp); } +?> ]]> </programlisting> </example>
Index: phpdoc-de/reference/datetime/functions/date.xml diff -u phpdoc-de/reference/datetime/functions/date.xml:1.6 phpdoc-de/reference/datetime/functions/date.xml:1.7 --- phpdoc-de/reference/datetime/functions/date.xml:1.6 Sun Dec 1 16:22:00 2002 +++ phpdoc-de/reference/datetime/functions/date.xml Fri Mar 21 12:43:32 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: betz Status: ready --> <refentry id="function.date"> <refnamediv> @@ -17,8 +17,10 @@ <para> Gibt einen formatierten String anhand eines vorzugebenden Musters zurück. Dabei wird entweder der angegebene - <parameter>Timestamp</parameter> oder die gegenwärtige lokale - Zeit berücksichtigt, wenn kein Timestamp angegegeben wird. + <parameter>Timestamp</parameter> oder die gegenwärtige lokale Zeit berücksichtigt, + wenn kein Timestamp angegegeben wird. Mit anderen Worten ausgedrückt: der Parameter + <parameter>Timestamp</parameter> ist optional und falls dieser nicht angegeben wird, + wird der Wert der Funktion <function>time</function> angenommen. </para> <note> <para> @@ -32,184 +34,209 @@ Um einen Timestamp aus aus einem Datums-String zu erzeugen, können Sie die Funktion <function>strtotime</function> benutzen. Zusätzlich bieten einige Datenbanken Funktionen, um Ihre Datumsfromate in Timestamps - umzuwandeln (wie z.B. die MySQL-Funktion UNIX_TIMESTAMP). + umzuwandeln (wie zum Beispiel MySQL's + <ulink url="&url.mysql.docs.date;">UNIX_TIMESTAMP</ulink> Funktion. </para> </note> <para> - Die folgenden Zeichen werden bei der Formatierung erkannt: - <itemizedlist> - <listitem> - <simpara> - a - "am" oder "pm" - </simpara> - </listitem> - <listitem> - <simpara> - A - "AM" oder "PM" - </simpara> - </listitem> - <listitem> - <simpara> - B - Swatch-Internet-Zeit - </simpara> - </listitem> - <listitem> - <simpara> - d - Tag des Monats, 2-stellig mit führender Null: "01" bis "31" - </simpara> - </listitem> - <listitem> - <simpara> - D - Tag der Woche als 3 Buchstaben, z.B. "Fri" - </simpara> - </listitem> - <listitem> - <simpara> - F - Monat als ganzes Wort, z.B "January" - </simpara> - </listitem> - <listitem> - <simpara> - g - Stunde im 12-Stunden-Format, ohne führende Null: "1" bis "12" - </simpara> - </listitem> - <listitem> - <simpara> - G - Stunde im 24-Stunden-Format, ohne führende Null: "0" bis "23" - </simpara> - </listitem> - <listitem> - <simpara> - h - Stunde im 12-Stunden-Format: "01" bis "12" - </simpara> - </listitem> - <listitem> - <simpara> - H - Stunde im 24-Stunden-Format: "00" bis "23" - </simpara> - </listitem> - <listitem> - <simpara> - i - Minuten: "00" bis "59" - </simpara> - </listitem> - <listitem> - <simpara> - I (großes 'i') - "1" bei Sommerzeit, sonst "0" - </simpara> - </listitem> - <listitem> - <simpara> - j - Tag des Monats ohne führende Null: "1" bis "31" - </simpara> - </listitem> - <listitem> - <simpara> - l - (kleines 'L') ausgeschriebener Tag der Woche, z.B. "Friday" - </simpara> - </listitem> - <listitem> - <simpara> - L - boolscher Wert für Schaltjahre: "0" oder "1" - </simpara> - </listitem> - <listitem> - <simpara> - m - Monat: "01" to "12" - </simpara> - </listitem> - <listitem> - <simpara> - M - Monat als 3 Buchstaben, z.B. "Jan" - </simpara> - </listitem> - <listitem> - <simpara> - n - Monat ohne führende Null: "1" bis "12" - </simpara> - </listitem> - <listitem> - <simpara> - O - Zeitdifferenz zur Greenwich Zeit in Stunden (z.B. +0200) - </simpara> - </listitem> - <listitem> - <simpara> - r - Nach RFC 822 formatiertes Datum; z.B.: - "Sun, 7 Oct 2001 14:56:02 +0200" (seit PHP 4.0.4) - </simpara> - </listitem> - <listitem> - <simpara> - s - Sekunden: "00" bis "59" - </simpara> - </listitem> - <listitem> - <simpara> - S - Anhang der englischen Aufzählung, 2 Buchstaben; z.B.:" - "st", "nd", "rd" oder "th" - </simpara> - </listitem> - <listitem> - <simpara> - t - Anzahl der Tage des angegebenen Monats: "28" bis "31" - </simpara> - </listitem> - <listitem> - <simpara> - T - Zeitzoneneinstellung des Rechners, z.B. "EST" oder "MDT" - </simpara> - </listitem> - <listitem> - <simpara> - U - Sekunden seit Beginn der UNIX-Epoche (January 1 1970 00:00:00 GMT) - </simpara> - </listitem> - <listitem> - <simpara> - w - Wochentag numerisch, beginnend mit "0" (Sonntag) bis "6" (Samstag) - </simpara> - </listitem> - <listitem> - <simpara> - W - ISO-8601 Wochennummer des Jahres (Woche beginnt mit Montag) - (seit PHP 4.1.0) - </simpara> - </listitem> - <listitem> - <simpara> - y - Jahr als zweistellige Zahl, z.B. "99" - </simpara> - </listitem> - <listitem> - <simpara> - Y - Jahr als vierstellige Zahl, z.B. "1999" - </simpara> - </listitem> - <listitem> - <simpara> - z - Tag des Jahres: "0" bis "365" - </simpara> - </listitem> - <listitem> - <simpara> - Z - Offset der Zeitzone gegen GTM ("-43200" bis "43200") in - Sekunden. Der Offset für Zeitzone West nach UTC ist immer negativ - und für Zeitzone Ost nach UTC immer positiv. - </simpara> - </listitem> - </itemizedlist> - Nicht erkannte Zeichen werden unverändert ausgegeben. Das - "Z"-Format gibt beim Gebrauch von <function>gmdate</function> immer - "0" zurück. + <table> + <title> + Die folgenden Zeichen werden im Parameter <parameter>Format</parameter>erkannt + </title> + <tgroup cols="3"> + <thead> + <row> + <entry><parameter>Format</parameter> Zeichen</entry> + <entry>Beschreibung</entry> + <entry>Beispiel für Rückgabewerte</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>a</literal></entry> + <entry>Kleingeschrieben: Ante meridiem und Post meridiem</entry> + <entry><literal>am</literal> oder <literal>pm</literal></entry> + </row> + <row> + <entry><literal>A</literal></entry> + <entry>Großgeschrieben: Ante meridiem und Post meridiem</entry> + <entry><literal>AM</literal> oder <literal>PM</literal></entry> + </row> + <row> + <entry><literal>B</literal></entry> + <entry>Swatch-Internet-Zeit</entry> + <entry><literal>000</literal> bis <literal>999</literal></entry> + </row> + <row> + <entry><literal>d</literal></entry> + <entry>Tag des Monats, 2-stellig mit führender Null</entry> + <entry><literal>01</literal> bis <literal>31</literal></entry> + </row> + <row> + <entry><literal>D</literal></entry> + <entry>Tag der Woche als mit drei Buchstaben</entry> + <entry><literal>Mon</literal> bis <literal>Sun</literal></entry> + </row> + <row> + <entry><literal>F</literal></entry> + <entry>Monat als ganzes Wort, wie January oder March</entry> + <entry><literal>January</literal> bis <literal>December</literal></entry> + </row> + <row> + <entry><literal>g</literal></entry> + <entry>12-Stunden-Format, ohne führende Nullen</entry> + <entry><literal>1</literal> bis <literal>12</literal></entry> + </row> + <row> + <entry><literal>G</literal></entry> + <entry>24-Stunden-Format, ohne führende Nullen</entry> + <entry><literal>0</literal> bis <literal>23</literal></entry> + </row> + <row> + <entry><literal>h</literal></entry> + <entry>12-Stunden-Format, mit führenden Nullen</entry> + <entry><literal>01</literal> bis <literal>12</literal></entry> + </row> + <row> + <entry><literal>H</literal></entry> + <entry>24-Stunden-Format, mit führenden Nullen</entry> + <entry><literal>00</literal> bis <literal>23</literal></entry> + </row> + <row> + <entry><literal>i</literal></entry> + <entry>Minuten mit führenden Nullen</entry> + <entry><literal>00</literal> bis <literal>59</literal></entry> + </row> + <row> + <entry><literal>I</literal> (großes i)</entry> + <entry>Fällt ein Datum in die Sommerzeit</entry> + <entry><literal>1</literal> bei Sommerzeit, ansonsten <literal>0</literal>.</entry> + </row> + <row> + <entry><literal>j</literal></entry> + <entry>Tag des Monats ohne führende Nullen</entry> + <entry><literal>1</literal> bis <literal>31</literal></entry> + </row> + <row> + <entry><literal>l</literal> (kleines 'L')</entry> + <entry>Ausgeschriebener Tag der Woche</entry> + <entry><literal>Sunday</literal> bis <literal>Saturday</literal></entry> + </row> + <row> + <entry><literal>L</literal></entry> + <entry>Schaltjahr oder nicht</entry> + <entry><literal>1</literal> für ein Schaltjahr, ansonsten <literal>0</literal>.</entry> + </row> + <row> + <entry><literal>m</literal></entry> + <entry>Monat als Zahl, mit führenden Nullen</entry> + <entry><literal>01</literal> bis <literal>12</literal></entry> + </row> + <row> + <entry><literal>M</literal></entry> + <entry>Monatsname mit drei Buchstaben</entry> + <entry><literal>Jan</literal> bis <literal>Dec</literal></entry> + </row> + <row> + <entry><literal>n</literal></entry> + <entry>Monatszahl, ohne führende Nullen</entry> + <entry><literal>1</literal> bis <literal>12</literal></entry> + </row> + <row> + <entry><literal>O</literal></entry> + <entry>Zeitunterschied zur Greenwich time (GMT) in Stunden</entry> + <entry>Beispiel: <literal>+0200</literal></entry> + </row> + <row> + <entry><literal>r</literal></entry> + <entry>RFC 822 formatiertes Datume</entry> + <entry>Beispiel: <literal>Thu, 21 Dec 2000 16:01:07 +0200</literal></entry> + </row> + <row> + <entry><literal>s</literal></entry> + <entry>Sekunden, mit führenden Nullen</entry> + <entry><literal>00</literal> bis <literal>59</literal></entry> + </row> + <row> + <entry><literal>S</literal></entry> + <entry>Anhang der englischen Aufzählung für einen Monatstag, zwei Zeichen</entry> + <entry> + <literal>st</literal>, <literal>nd</literal>, <literal>rd</literal> oder + <literal>th</literal>. Zur Verwendung mit <literal>j</literal> empfohlen. + </entry> + </row> + <row> + <entry><literal>t</literal></entry> + <entry>Anzahl der Tage des angegebenen Monats</entry> + <entry><literal>28</literal> bis <literal>31</literal></entry> + </row> + <row> + <entry><literal>T</literal></entry> + <entry>Zeitzoneneinstellung des Rechners</entry> + <entry>Beispiele: <literal>EST</literal>, <literal>MDT</literal> ...</entry> + </row> + <row> + <entry><literal>U</literal></entry> + <entry> Sekunden seit Beginn der UNIX-Epoche (January 1 1970 00:00:00 GMT)</entry> + <entry>Siehe auch <function>time</function></entry> + </row> + <row> + <entry><literal>w</literal></entry> + <entry>Numerischer Tag einer Woche</entry> + <entry><literal>0</literal> (für Sonntag) bis <literal>6</literal> (für Samstag)</entry> + </row> + <row> + <entry><literal>W</literal></entry> + <entry>ISO-8601 Wochennummer des Jahres, die Woche beginnt am Montag (hinzugefügt in PHP 4.1.0)</entry> + <entry>Beispiel: <literal>42</literal> (die 42 Woche im Jahr)</entry> + </row> + <row> + <entry><literal>Y</literal></entry> + <entry>Vierstellige Jahreszahl</entry> + <entry>Beispiel: <literal>1999</literal> oder <literal>2003</literal></entry> + </row> + <row> + <entry><literal>y</literal></entry> + <entry>Jahreszahl, zweistellig</entry> + <entry>Beispiele: <literal>99</literal> oder <literal>03</literal></entry> + </row> + <row> + <entry><literal>z</literal></entry> + <entry>Der Tag eines Jahres</entry> + <entry><literal>0</literal> bis <literal>366</literal></entry> + </row> + <row> + <entry><literal>Z</literal></entry> + <entry> + Offset der Zeitzone in Sekunden. Der Offset für Zeitzone West nach + UTC ist immer negativ und für Zeitzone Ost nach UTC immer positiv. + </entry> + <entry><literal>-43200</literal> bis <literal>43200</literal></entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Nicht erkannte Zeichen werden unverändert ausgegeben. Das <literal>Z</literal> + Format gibt beim Gebrauch von <function>gmdate</function> immer + <literal>0</literal> zurück. </para> <para> <example> <title><function>date</function> Beispiel</title> <programlisting role="php"> <![CDATA[ -print (date("l dS of F Y h:i:s A")); -print ("July 1, 2000 is on a " . date ("l", mktime(0,0,0,7,1,2000))); +<?php +// Gibt etwas ähnliches zu Wednesday aus +echo date("l"); + +// Gibt etwas ähnliches aus wie: Wednesday 15th of January 2003 05:51:38 AM +echo date ("l dS of F Y h:i:s A"); + +// Ausgabe: July 1, 2000 ist ein Samstag +echo "July 1, 2000 ist ein " . date ("l", mktime(0,0,0,7,1,2000)); +?> ]]> </programlisting> </example> @@ -223,7 +250,8 @@ <title>Escaping von Zeichen in <function>date</function></title> <programlisting role="php"> <![CDATA[ -echo date("l \\t\h\e jS"); // gibt etwas ähnliches aus wie 'Saturday the 8th' + // gibt etwas ähnliches aus wie 'Wednesday the 15th' +echo date("l \\t\h\e jS"); ]]> </programlisting> </example> @@ -231,7 +259,7 @@ <para> Es ist möglich, <function>date</function> und <function>mktime</function> gleichzeitig zu verwenden, um - Datumsangaben der Zukunft/Vergangenheit herauszufinden. + Datumsangaben in der Zukunft/Vergangenheit zu bestimmen. <example> <title> <function>date</function> und <function>mktime</function> @@ -239,16 +267,18 @@ </title> <programlisting role="php"> <![CDATA[ +<?php $morgen = mktime(0, 0, 0, date("m"), date ("d")+1, date("Y")); $letztermonat = mktime(0, 0, 0, date("m")-1, date("d"), date("Y")); $naechstesjahr = mktime(0, 0, 0, date("m"), date("d"), date("Y")+1); +?> ]]> </programlisting> </example> <note> <para> Dieses Vorgehen kann zu verlässlicheren Ergebnissen führen, als simples - Addieren oder Subtrahieren der Anzahl von Sekunden in Tagen oder Monaten + addieren oder subtrahieren der Anzahl von Sekunden in Tagen oder Monaten zu einem Timestamp, da Sommer- und Winterzeit berücksichtigt werden. </para> </note> @@ -268,7 +298,9 @@ </title> <programlisting role="php"> <![CDATA[ -/* Today is March 10th, 2001, 5:16:18 pm */ +<?php +// Angenommen heute ist 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 @@ -278,22 +310,24 @@ $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> Um Datumsangaben in anderen Sprach-/Zeitzonen-Formaten - auszugeben, sollten sie die Funktionen - <function>setlocale</function> und <function>strftime</function> + auszugeben, sollten sie die Funktionen <function>setlocale</function> + und <function>strftime</function> benutzen. nutzen. </para> <para> - Siehe auch: <function>getlastmod</function>, - <function>gmdate</function>, - <function>mktime</function>, - <function>strftime</function> - und <function>time</function>. + Siehe auch + <function>getlastmod</function>, + <function>gmdate</function>, + <function>mktime</function>, + <function>strftime</function> + und <function>time</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/datetime/functions/getdate.xml diff -u phpdoc-de/reference/datetime/functions/getdate.xml:1.4 phpdoc-de/reference/datetime/functions/getdate.xml:1.5 --- phpdoc-de/reference/datetime/functions/getdate.xml:1.4 Sun Jun 9 06:55:30 2002 +++ phpdoc-de/reference/datetime/functions/getdate.xml Fri Mar 21 12:43:32 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.getdate"> <refnamediv> @@ -16,60 +16,77 @@ <para> Gibt ein assoziatives Array mit Datums- und Zeitangaben des angegebenen <parameter>Timestamp</parameter> zurück. Wird kein Timestamp - angegeben, wird die lokal gültige Zeit berücksichtigt. Die Arrayelemente - sind folgende: - <itemizedlist> - <listitem> - <simpara> - "seconds" - Sekunden - </simpara> - </listitem> - <listitem> - <simpara> - "minutes" - Minuten - </simpara> - </listitem> - <listitem> - <simpara> - "hours" - Stunden - </simpara> - </listitem> - <listitem> - <simpara> - "mday" - Tag des Monats - </simpara> - </listitem> - <listitem> - <simpara> - "wday" - numerischer Tag der Woche: von 0 als Sonntag bis 6 als Samstag - </simpara> - </listitem> - <listitem> - <simpara> - "mon" - Monat als Zahl - </simpara> - </listitem> - <listitem> - <simpara> - "year" - Jahr als Zahl - </simpara> - </listitem> - <listitem> - <simpara> - "yday" - Tag des Jahres als Zahlwert, z.B. "299" - </simpara> - </listitem> - <listitem> - <simpara> - "weekday" - ausgeschriebener Wochentag, z.B. "Friday" - </simpara> - </listitem> - <listitem> - <simpara> - "month" - ausgeschriebener Monatsname, z.B. "January" - </simpara> - </listitem> - </itemizedlist> + angegeben, wird die lokal gültige Zeit berücksichtigt. Die assoziativen + Arrayelemente sind folgende: + </para> + <para> + <table> + <title>The following characters are recognized in the + <parameter>format</parameter> parameter string</title> + <tgroup cols=""> + <thead> + <row> + <entry>Key</entry> + <entry>Beschreibung</entry> + <entry>Beispiel für Rückgabewerte</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>"seconds"</literal></entry> + <entry>Anzahl der Sekunden</entry> + <entry>zwischen <literal>0</literal> und <literal>59</literal></entry> + </row> + <row> + <entry><literal>"minutes"</literal></entry> + <entry>Anzahl der Minuten</entry> + <entry>zwischen <literal>0</literal> und <literal>59</literal></entry> + </row> + <row> + <entry><literal>"hours"</literal></entry> + <entry>Anzahl der Stunden</entry> + <entry>zwischen <literal>0</literal> und <literal>23</literal></entry> + </row> + <row> + <entry><literal>"mday"</literal></entry> + <entry>Numersicher Tag des Monats</entry> + <entry>zwischen <literal>1</literal> und <literal>31</literal></entry> + </row> + <row> + <entry><literal>"wday"</literal></entry> + <entry>Numerischer Wochentag</entry> + <entry>zwischen <literal>0</literal> (für Sonntag) und <literal>6</literal> (für Samstag)</entry> + </row> + <row> + <entry><literal>"mon"</literal></entry> + <entry>Monatszahl</entry> + <entry>zwischen <literal>1</literal> und <literal>12</literal></entry> + </row> + <row> + <entry><literal>"year"</literal></entry> + <entry>Vierstellige Jahreszahl</entry> + <entry>Beispiele: <literal>1999</literal> oder <literal>2003</literal></entry> + </row> + <row> + <entry><literal>"yday"</literal></entry> + <entry>Numerischer Tag des Jahres</entry> + <entry>zwischen <literal>0</literal> und <literal>366</literal></entry> + </row> + <row> + <entry><literal>"weekday"</literal></entry> + <entry>Ausgeschriebener Wochentag</entry> + <entry>zwischen <literal>Sonntag</literal> und <literal>Samstag</literal></entry> + </row> + <row> + <entry><literal>"month"</literal></entry> + <entry>Ausgeschriebener Monatsname, wie Januar oder März</entry> + <entry>zwischen<literal>Januar></literal> und <literal>Dezember</literal></entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> <example> <title> <function>getdate</function> Beispiel @@ -79,7 +96,7 @@ $heute = getdate(); $monat = $heute['month']; $tag_monat = $heute['mday']; -$Jahr = $heute['year']; +$jahr = $heute['year']; echo "$monat $tag_monat, $jahr"; ]]> </programlisting> Index: phpdoc-de/reference/datetime/functions/gmdate.xml diff -u phpdoc-de/reference/datetime/functions/gmdate.xml:1.6 phpdoc-de/reference/datetime/functions/gmdate.xml:1.7 --- phpdoc-de/reference/datetime/functions/gmdate.xml:1.6 Sun Dec 1 16:22:00 2002 +++ phpdoc-de/reference/datetime/functions/gmdate.xml Fri Mar 21 12:43:32 2003 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.6 Maintainer: betz Status: ready --> <refentry id="function.gmdate"> <refnamediv> <refname>gmdate</refname> - <refpurpose>Formatiert eine GMT/CUT Zeit- Datumsangabe</refpurpose> + <refpurpose>Formatiert eine GMT/UTC Zeit- Datumsangabe</refpurpose> </refnamediv> <refsect1> <title>Beschreibung:</title> @@ -24,17 +24,41 @@ <title><function>gmdate</function> Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php echo date ("M d Y H:i:s", mktime (0,0,0,1,1,1998)); echo gmdate("M d Y H:i:s", mktime (0,0,0,1,1,1998)); +?> ]]> </programlisting> </example> </para> + <note> + <para> + Bei den Microsoft Betriebssystemen ist die Systembibliothek, die diese + Funktionalität zur Verfügung stellt, defekt. Das hat zur Folge, dass + <function>gmdate</function> keine negativen Werte für den + <parameter>Timestamp</parameter> unterstützt.Weitere Details können Sie + folgenden Bugreports entnehmen: + <ulink url="&url.php.bugs;22620">#22620</ulink>, + <ulink url="&url.php.bugs;22457">#22457</ulink> + und <ulink url="&url.php.bugs;14391">#14391</ulink>. + </para> + <para> + Bei Unix/Linux Systemen ist dieses Problem nicht vorhanden. Hier funkfionieren + die Systembibliotheken wie erwartet. + </para> + <para> + PHP kann keine defekten Systembibliotheken reparieren. Kontaktieren Sie den + Verkaüfer Ihres Betriebssystems und bitten Sie um Reparatur für dieses und + ähnliche Probleme. + </para> + </note> <para> - Siehe auch: <function>date</function>, - <function>mktime</function>, - <function>gmmktime</function> und - <function>strftime</function>. + Siehe auch + <function>date</function>, + <function>mktime</function>, + <function>gmmktime</function> und + <function>strftime</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/datetime/functions/gmstrftime.xml diff -u phpdoc-de/reference/datetime/functions/gmstrftime.xml:1.4 phpdoc-de/reference/datetime/functions/gmstrftime.xml:1.5 --- phpdoc-de/reference/datetime/functions/gmstrftime.xml:1.4 Sun Jun 9 06:55:30 2002 +++ phpdoc-de/reference/datetime/functions/gmstrftime.xml Fri Mar 21 12:43:32 2003 @@ -1,12 +1,12 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: betz Status: ready --> <refentry id="function.gmstrftime"> <refnamediv> <refname>gmstrftime</refname> <refpurpose> - Formatiert eine Datum-/Zeitangabe in GMT/CUT-Format entsprechend den + Formatiert eine Datum-/Zeitangabe in GMT/UTC-Format entsprechend den lokalen Einstellungen </refpurpose> </refnamediv> @@ -27,9 +27,11 @@ <title><function>gmstrftime</function> Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php setlocale (LC_TIME, 'de_DE'); echo strftime ("%b %d %Y %H:%M:%S", mktime(0,0,0,12,31,98))."\n"; echo gmstrftime ("%b %d %Y %H:%M:%S", mktime(0,0,0,12,31,98))."\n"; +?> ]]> </programlisting> </example> Index: phpdoc-de/reference/datetime/functions/microtime.xml diff -u phpdoc-de/reference/datetime/functions/microtime.xml:1.4 phpdoc-de/reference/datetime/functions/microtime.xml:1.5 --- phpdoc-de/reference/datetime/functions/microtime.xml:1.4 Sun Jun 9 06:55:30 2002 +++ phpdoc-de/reference/datetime/functions/microtime.xml Fri Mar 21 12:43:32 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.microtime"> <refnamediv> @@ -29,6 +29,7 @@ <title><function>microtime</function> Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php function getmicrotime(){ list($usec, $sec) = explode(" ",microtime()); return ((float)$usec + (float)$sec); @@ -44,6 +45,7 @@ $time = $time_end - $time_start; echo "Nichts getan in $time Sekunden"; +?> ]]> </programlisting> </example> Index: phpdoc-de/reference/datetime/functions/mktime.xml diff -u phpdoc-de/reference/datetime/functions/mktime.xml:1.6 phpdoc-de/reference/datetime/functions/mktime.xml:1.7 --- phpdoc-de/reference/datetime/functions/mktime.xml:1.6 Sun Dec 1 16:22:00 2002 +++ phpdoc-de/reference/datetime/functions/mktime.xml Fri Mar 21 12:43:32 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> <refentry id="function.mktime"> <refnamediv> @@ -35,16 +35,16 @@ </para> <para> Einzelne Argumente können von rechts nach links weggelassen - werden. Sie werden dann ersetzt mit den Werten der lokalen - Systemzeit bzw. des lokalen Systemdatums. + werden. Sie werden dann mit den Werten der lokalen Systemzeit bzw. + des lokalen Systemdatums ersetzt. </para> <para> <parameter>is_dst</parameter> kann bei Sommerzeit auf 1 gesetzt werden. 0 bedeutet Winter-/Normalzeit, -1 (Vorgabewert) heißt, dass nicht bekannt ist, ob Sommer- oder Winterzeit - herrscht. Falls nicht bekannt ist (-1), ob Sommer- oder Winterzeit + herrscht. Falls nicht bekannt ist, ob Sommer- oder Winterzeit herrscht, versucht PHP selbst dies herauszufinden. Das kann zu - unerwarteten (aber richtigen) Ergebnissen führen. + unerwarteten (aber dennoch korrekten) Ergebnissen führen. </para> <note> <para> @@ -60,18 +60,31 @@ <title><function>mktime</function> Beispiel</title> <programlisting> <![CDATA[ +<?php 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> Das <parameter>Jahr</parameter> darf zwei- oder vierstellig angegeben werden. Werte von 0 bis 69 stehen dann für die Jahre 2000 bis 2069, und 70 bis 99 für die Jahre von 1970-1999 (auf Systemen, - die time_t als 32Bit-Integer abbilden, liegt der gültige Bereich - für <parameter>Jahr</parameter> zwischen 1902 und 2037). + die time_t als 32Bit-Integer abbilden, was heutzutage gebräuchlich ist, liegt + der gültige Bereich für den Parameter <parameter>Jahr</parameter> irgendwo + zwischen 1901 und 2038). + </para> + <para> + <note> + <title>Windows</title> + <simpara> + Negative Timestampwerte werden von keiner uns bekannten Windowsversion + unterstützt. Aus diesem Grund ist der Gültigkeitsbereich für Jahresangaben + auf Werte zwischen 1970 und 2038 eingeschränkt. + </simpara> + </note> </para> <para> Der letzte Tag eines gegebenen Monats kann als der Tag "0" des @@ -81,11 +94,15 @@ <example> <title>Letzter Tag des nächsten Monats</title> <programlisting> +<![CDATA[ +<?php $lastday = mktime (0,0,0,3,0,2000); echo strftime ("Letzter Tag im Feb. 2000 ist der %d.", $lastday); $lastday = mktime(0,0,0,4,-31,2000); echo strftime ("Letzter Tag im Feb. 2000 ist der %d.", $lastday); +?> +]]> </programlisting> </example> </para> Index: phpdoc-de/reference/datetime/functions/strftime.xml diff -u phpdoc-de/reference/datetime/functions/strftime.xml:1.9 phpdoc-de/reference/datetime/functions/strftime.xml:1.10 --- phpdoc-de/reference/datetime/functions/strftime.xml:1.9 Fri Dec 13 19:04:28 2002 +++ phpdoc-de/reference/datetime/functions/strftime.xml Fri Mar 21 12:43:32 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.4 Maintainer: betz Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.6 Maintainer: betz Status: ready --> <refentry id="function.strftime"> <refnamediv> @@ -238,13 +238,15 @@ Es ist durchaus möglich, dass Ihre C-Bibliothek nicht alle angegebenen Formatierungszeichen erkennt. In diesem Fall werden diese Zeichen von der PHP-Funktion <function>strftime</function> nicht unterstützt. Das - bedeutet, dass z.B. %e, %T, %R und %D (vielleicht noch weitere) auf + bedeutet, dass z.B. %e, %T, %R und %D (und vielleicht noch weitere) auf Windowssystemen nicht funktionieren. </para> </note> <example> - <title><function>strftime</function> Beispiel</title> + <title><function>strftime</function> locale Beispiel</title> <programlisting role="php"> +<![CDATA[ +<?php setlocale (LC_TIME, "C"); print (strftime ("%A in Finnland ist ")); setlocale (LC_TIME, "fi_FI"); @@ -253,11 +255,74 @@ print (strftime ("%A und in Deutschland ")); setlocale (LC_TIME, "de_DE"); print (strftime ("%A.\n")); +?> +]]> </programlisting> </example> - Diese Beispiele funktionieren nur, wenn auf Ihrem System die entsprechenden - Locale-Codes installiert sind. - </para> + Dieses Beispiel funktioniert nur, wenn auf Ihrem System die entsprechenden + Locale-Codes installiert sind. + <note> + <simpara> + %G und %V basieren auf ISO 8601:1988 Wochennummern und können unerwartete + (obwohl korrekte) Ergebnisse liefern, wenn Sie das Nummernsystem nicht + gründlich verstehen. Sehen Sie weiter oben bei %V nach und beachten Sie die + folgenden Beispiele. + </simpara> + </note> + <example> + <title>ISO 8601:1988 Wochennummer Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php +/* December 2002 / January 2003 +ISOWk M Tu W Thu F Sa Su +----- ---------------------------- +51 16 17 18 19 20 21 22 +52 23 24 25 26 27 28 29 +1 30 31 1 2 3 4 5 +2 6 7 8 9 10 11 12 +3 13 14 15 16 17 18 19 */ + +// Ausgabe: 12/28/2002 - %V,%G,%Y = 52,2002,2002 +print "12/28/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/28/2002")) . "\n"; + +// Ausgabe: 12/30/2002 - %V,%G,%Y = 1,2003,2002 +print "12/30/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/30/2002")) . "\n"; + +// Ausgabe: 1/3/2003 - %V,%G,%Y = 1,2003,2003 +print "1/3/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2003")) . "\n"; + +// Ausgabe: 1/10/2003 - %V,%G,%Y = 2,2003,2003 +print "1/10/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/10/2003")) . "\n"; + + + +/* December 2004 / January 2005 +ISOWk M Tu W Thu F Sa Su +----- ---------------------------- +51 13 14 15 16 17 18 19 +52 20 21 22 23 24 25 26 +53 27 28 29 30 31 1 2 +1 3 4 5 6 7 8 9 +2 10 11 12 13 14 15 16 */ + +// Ausgabe: 12/23/2004 - %V,%G,%Y = 52,2004,2004 +print "12/23/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/23/2004")) . "\n"; + +// Ausgabe: 12/31/2004 - %V,%G,%Y = 53,2004,2004 +print "12/31/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/31/2004")) . "\n"; + +// Ausgabe: 1/2/2005 - %V,%G,%Y = 53,2004,2005 +print "1/2/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/2/2005")) . "\n"; + +// Ausgabe: 1/3/2005 - %V,%G,%Y = 1,2005,2005 +print "1/3/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2005")) . "\n"; + +?> +]]> + </programlisting> + </example> + </para> <para> Siehe auch <function>setlocale</function>, <function>mktime</function> und die <ulink url="&spec.strftime;"> Index: phpdoc-de/reference/datetime/functions/strtotime.xml diff -u phpdoc-de/reference/datetime/functions/strtotime.xml:1.6 phpdoc-de/reference/datetime/functions/strtotime.xml:1.7 --- phpdoc-de/reference/datetime/functions/strtotime.xml:1.6 Sun Dec 1 16:22:00 2002 +++ phpdoc-de/reference/datetime/functions/strtotime.xml Fri Mar 21 12:43:32 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.2 Maintainer: betz Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.3 Maintainer: betz Status: ready --> <refentry id="function.strtotime"> <refnamediv> @@ -36,6 +36,7 @@ <title><function>strtotime</function>-Beispiele:</title> <programlisting role="php"> <![CDATA[ +<?php echo strtotime ("now"), "\n"; echo strtotime ("10 September 2000"), "\n"; echo strtotime ("+1 day"), "\n"; @@ -43,6 +44,7 @@ echo strtotime ("+1 week 2 days 4 hours 2 seconds"), "\n"; echo strtotime ("next Thursday"), "\n"; echo strtotime ("last Monday"), "\n"; +?> ]]> </programlisting> </example> @@ -52,12 +54,14 @@ <title>Fehlerüberprüfung</title> <programlisting role="php"> <![CDATA[ +<?php $str = 'Nicht gut'; if (($timestamp = strtotime($str)) === -1) { echo "Der String ($str) ist falsch."; } else { echo "$str == ". date('l dS of F Y h:i:s A',$timestamp); } +?> ]]> </programlisting> </example>