cvs: phpdoc-de /reference/datetime reference.xml /reference/datetime/functions checkdate.xml date.xml gmdate.xml mktime.xml strftime.xml
strtotime.xml

From:	Mark Wiesemann	Date:	Sun, 01 Dec 2002 21:22:01 +0000
Subject:	cvs: phpdoc-de /reference/datetime reference.xml /reference/datetime/functions checkdate.xml date.xml gmdate.xml mktime.xml strftime.xml strtotime.xml
Groups:	php.doc.de
Request:	Send a blank email to doc-de+get-358@lists.php.net to get a copy of this message

wiesemann Sun Dec 1 16:22:01 2002 EDT Modified files: /phpdoc-de/reference/datetime reference.xml /phpdoc-de/reference/datetime/functions date.xml strtotime.xml strftime.xml mktime.xml gmdate.xml checkdate.xml Log: rechange to unix line endings, sorry

Index: phpdoc-de/reference/datetime/reference.xml diff -u phpdoc-de/reference/datetime/reference.xml:1.7 phpdoc-de/reference/datetime/reference.xml:1.8 --- phpdoc-de/reference/datetime/reference.xml:1.7 Sun Dec 1 16:12:00 2002 +++ phpdoc-de/reference/datetime/reference.xml Sun Dec 1 16:22:00 2002 @@ -1,77 +1,77 @@ -<?xml version="1.0" encoding="iso-8859-1"?> - - - - <reference id="ref.datetime"> - <title>Datums- und Zeit-Funktionen</title> - <titleabbrev>Datum/Zeit</titleabbrev> - <partintro> - <section id="datetime.intro"> - &reftitle.intro; - <para> - Diese Funktionen ermöglichen es Ihnen, Datums- - und Zeitangaben vom Server, auf dem PHP läuft, abzufragen. - Die Ausgabe von Datums- und Zeitangaben kann mit Hilfe dieser Funktionen - in unterschiedlichster Weise formatiert werden. - </para> - <note> - <simpara> - Beachten Sie bitte, dass diese Funktionen von den lokalen - Systemeinstellungen Ihres Servers abhängen. Ein besonderes Augenmerk - sollten Sie auf Sommer- und Winterzeit und Schaltjahre haben. - </simpara> - </note> - - </section> - - <section id="datetime.required"> - &reftitle.required; - &no.requirement; - </section> - - <section id="datetime.installation"> - &reftitle.install; - &no.install; - </section> - - <section id="datetime.runtime"> - &reftitle.runtime; - &no.config; - </section> - - <section id="datetime.resources"> - &reftitle.resources; - &no.resource; - </section> - - <section id="datetime.constants"> - &reftitle.constants; - &no.constants; - </section> - - </partintro> - -&reference.datetime.functions; - - </reference> - - +<?xml version="1.0" encoding="iso-8859-1"?> + + + + <reference id="ref.datetime"> + <title>Datums- und Zeit-Funktionen</title> + <titleabbrev>Datum/Zeit</titleabbrev> + <partintro> + <section id="datetime.intro"> + &reftitle.intro; + <para> + Diese Funktionen ermöglichen es Ihnen, Datums- + und Zeitangaben vom Server, auf dem PHP läuft, abzufragen. + Die Ausgabe von Datums- und Zeitangaben kann mit Hilfe dieser Funktionen + in unterschiedlichster Weise formatiert werden. + </para> + <note> + <simpara> + Beachten Sie bitte, dass diese Funktionen von den lokalen + Systemeinstellungen Ihres Servers abhängen. Ein besonderes Augenmerk + sollten Sie auf Sommer- und Winterzeit und Schaltjahre haben. + </simpara> + </note> + + </section> + + <section id="datetime.required"> + &reftitle.required; + &no.requirement; + </section> + + <section id="datetime.installation"> + &reftitle.install; + &no.install; + </section> + + <section id="datetime.runtime"> + &reftitle.runtime; + &no.config; + </section> + + <section id="datetime.resources"> + &reftitle.resources; + &no.resource; + </section> + + <section id="datetime.constants"> + &reftitle.constants; + &no.constants; + </section> + + </partintro> + +&reference.datetime.functions; + + </reference> + + Index: phpdoc-de/reference/datetime/functions/date.xml diff -u phpdoc-de/reference/datetime/functions/date.xml:1.5 phpdoc-de/reference/datetime/functions/date.xml:1.6 --- phpdoc-de/reference/datetime/functions/date.xml:1.5 Sun Dec 1 16:12:00 2002 +++ phpdoc-de/reference/datetime/functions/date.xml Sun Dec 1 16:22:00 2002 @@ -1,320 +1,320 @@ -<?xml version="1.0" encoding="iso-8859-1"?> - - - - <refentry id="function.date"> - <refnamediv> - <refname>date</refname> - <refpurpose>Formatiert ein(e) angegebene(s) Zeit/Datum</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>string</type><methodname>date</methodname> - <methodparam><type>string</type><parameter>Format</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>Timestamp</parameter></methodparam> - </methodsynopsis> - <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. - </para> - <note> - <para> - Der gültige Bereich eines Timestamp liegt typischerweise zwischen - Fri, 13 Dec 1901 20:45:54 GMT und Tue, 19 Jan 2038 03:14:07 GMT. - (Das entspricht den minimalen und maximalen Werten für einen - vorzeichenbehafteten 32-Bit Integer). Auf Windows-Betribssytemen - liegt ist dieser Bereich beschränkt auf 01-01-1970 bis 19-01-2038. - </para> - <para> - 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). - </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. - </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))); -]]> - </programlisting> - </example> - </para> - <para> - Möchten Sie verhindern, dass ein erkanntes Zeichen im Formatstring - ersetzt wird, sollten Sie dieses Zeichen mit einem vorangestellten - Backslash escapen. Ist das Zeichen mit dem Backslash bereits eine - spezielle Zeichenfolge, müssen Sie diesen Backslash ebenso escapen. - <example> - <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' -]]> - </programlisting> - </example> - </para> - <para> - Es ist möglich, <function>date</function> und - <function>mktime</function> gleichzeitig zu verwenden, um - Datumsangaben der Zukunft/Vergangenheit herauszufinden. - <example> - <title> - <function>date</function> und <function>mktime</function> - Beispiele - </title> - <programlisting role="php"> -<![CDATA[ -$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 - zu einem Timestamp, da Sommer- und Winterzeit berücksichtigt werden. - </para> - </note> - </para> - <para> - Es folgen einige Beispiele zur <function>date</function> Formatierung. - Beachten Sie, dass Sie alle anderen Zeichen escapen sollten, da alle - Zeichen, die im Augenblick eine spezielle Bedeutung haben, unerwünschte - Resultate liefern. Bei allen weiteren Zeichen kann es durchaus möglich - sein, dass diesen in zukünftigen PHP-Versionen eine Bedeutung zukommt. - Beim escapen sollten Sie darauf achten einfache Anführungszeichen zu - benutzen, damit Zeichenfolgen wie zum Beispiel \n zu keinem - Zeilenumbruch führen. - <example> - <title> - <function>date</function> Formatierungen - </title> - <programlisting role="php"> -<![CDATA[ -/* Today is 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> - Um Datumsangaben in anderen Sprach-/Zeitzonen-Formaten - auszugeben, sollten sie die Funktionen - <function>setlocale</function> und <function>strftime</function> - nutzen. - </para> - <para> - Siehe auch: <function>getlastmod</function>, - <function>gmdate</function>, - <function>mktime</function>, - <function>strftime</function> - und <function>time</function>. - </para> - </refsect1> - </refentry> - - +<?xml version="1.0" encoding="iso-8859-1"?> + + + + <refentry id="function.date"> + <refnamediv> + <refname>date</refname> + <refpurpose>Formatiert ein(e) angegebene(s) Zeit/Datum</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung:</title> + <methodsynopsis> + <type>string</type><methodname>date</methodname> + <methodparam><type>string</type><parameter>Format</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>Timestamp</parameter></methodparam> + </methodsynopsis> + <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. + </para> + <note> + <para> + Der gültige Bereich eines Timestamp liegt typischerweise zwischen + Fri, 13 Dec 1901 20:45:54 GMT und Tue, 19 Jan 2038 03:14:07 GMT. + (Das entspricht den minimalen und maximalen Werten für einen + vorzeichenbehafteten 32-Bit Integer). Auf Windows-Betribssytemen + liegt ist dieser Bereich beschränkt auf 01-01-1970 bis 19-01-2038. + </para> + <para> + 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). + </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. + </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))); +]]> + </programlisting> + </example> + </para> + <para> + Möchten Sie verhindern, dass ein erkanntes Zeichen im Formatstring + ersetzt wird, sollten Sie dieses Zeichen mit einem vorangestellten + Backslash escapen. Ist das Zeichen mit dem Backslash bereits eine + spezielle Zeichenfolge, müssen Sie diesen Backslash ebenso escapen. + <example> + <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' +]]> + </programlisting> + </example> + </para> + <para> + Es ist möglich, <function>date</function> und + <function>mktime</function> gleichzeitig zu verwenden, um + Datumsangaben der Zukunft/Vergangenheit herauszufinden. + <example> + <title> + <function>date</function> und <function>mktime</function> + Beispiele + </title> + <programlisting role="php"> +<![CDATA[ +$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 + zu einem Timestamp, da Sommer- und Winterzeit berücksichtigt werden. + </para> + </note> + </para> + <para> + Es folgen einige Beispiele zur <function>date</function> Formatierung. + Beachten Sie, dass Sie alle anderen Zeichen escapen sollten, da alle + Zeichen, die im Augenblick eine spezielle Bedeutung haben, unerwünschte + Resultate liefern. Bei allen weiteren Zeichen kann es durchaus möglich + sein, dass diesen in zukünftigen PHP-Versionen eine Bedeutung zukommt. + Beim escapen sollten Sie darauf achten einfache Anführungszeichen zu + benutzen, damit Zeichenfolgen wie zum Beispiel \n zu keinem + Zeilenumbruch führen. + <example> + <title> + <function>date</function> Formatierungen + </title> + <programlisting role="php"> +<![CDATA[ +/* Today is 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> + Um Datumsangaben in anderen Sprach-/Zeitzonen-Formaten + auszugeben, sollten sie die Funktionen + <function>setlocale</function> und <function>strftime</function> + nutzen. + </para> + <para> + 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/strtotime.xml diff -u phpdoc-de/reference/datetime/functions/strtotime.xml:1.5 phpdoc-de/reference/datetime/functions/strtotime.xml:1.6 --- phpdoc-de/reference/datetime/functions/strtotime.xml:1.5 Sun Dec 1 16:12:00 2002 +++ phpdoc-de/reference/datetime/functions/strtotime.xml Sun Dec 1 16:22:00 2002 @@ -1,95 +1,95 @@ -<?xml version="1.0" encoding="iso-8859-1"?> - - - - <refentry id="function.strtotime"> - <refnamediv> - <refname>strtotime</refname> - <refpurpose> - Wandelt ein beliebiges Datum (englisches Format) in einen - UNIX-Zeitstempel (Timestamp) um. - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>int</type><methodname>strtotime</methodname> - <methodparam><type>string</type><parameter>time</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>now</parameter></methodparam> - </methodsynopsis> - <simpara> - Diese Funktion erwartet einen String mit einem Datum im - englischen Format und versucht, diesen in einen UNIX-Timestamp - umzusetzen. Versucht wird dies relativ zu dem Timestamp, den Sie mit - <parameter>now</parameter> angeben. Fehlt diese Angabe, wird die aktuelle - Zeit angenommen. Schlägt die Umwandlung fehl, wird <literal>-1</literal> - zurückgegeben. - </simpara> - <simpara> - Die Funktion <function>strtotime</function> verhält sich gemäß der Syntax von - GNU Date. Daher sollten Sie einen Blick in die GNU Manual Seite - <ulink url="&url.gnu.man.date-input;">Date Input Formats</ulink> werfen. - Dort wird die gültige Syntax für <parameter>time</parameter> beschrieben. - </simpara> - <para> - <example> - <title><function>strtotime</function>-Beispiele:</title> - <programlisting role="php"> -<![CDATA[ -echo strtotime ("now"), "\n"; -echo strtotime ("10 September 2000"), "\n"; -echo strtotime ("+1 day"), "\n"; -echo strtotime ("+1 week"), "\n"; -echo strtotime ("+1 week 2 days 4 hours 2 seconds"), "\n"; -echo strtotime ("next Thursday"), "\n"; -echo strtotime ("last Monday"), "\n"; -]]> - </programlisting> - </example> - </para> - <para> - <example> - <title>Fehlerüberprüfung</title> - <programlisting role="php"> -<![CDATA[ -$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> - </para> - <note> - <para> - Der gültige Bereich eines Timestamp liegt typischerweise zwischen - Fri, 13 Dec 1901 20:45:54 GMT und Tue, 19 Jan 2038 03:14:07 GMT. - (Das sind die Datumsangaben, die dem minimalen und maximalen Wert eines - vorzeichenbehafteten 32-bit Integer entsprechen.) - </para> - </note> - </refsect1> - </refentry> - - +<?xml version="1.0" encoding="iso-8859-1"?> + + + + <refentry id="function.strtotime"> + <refnamediv> + <refname>strtotime</refname> + <refpurpose> + Wandelt ein beliebiges Datum (englisches Format) in einen + UNIX-Zeitstempel (Timestamp) um. + </refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung:</title> + <methodsynopsis> + <type>int</type><methodname>strtotime</methodname> + <methodparam><type>string</type><parameter>time</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>now</parameter></methodparam> + </methodsynopsis> + <simpara> + Diese Funktion erwartet einen String mit einem Datum im + englischen Format und versucht, diesen in einen UNIX-Timestamp + umzusetzen. Versucht wird dies relativ zu dem Timestamp, den Sie mit + <parameter>now</parameter> angeben. Fehlt diese Angabe, wird die aktuelle + Zeit angenommen. Schlägt die Umwandlung fehl, wird <literal>-1</literal> + zurückgegeben. + </simpara> + <simpara> + Die Funktion <function>strtotime</function> verhält sich gemäß der Syntax von + GNU Date. Daher sollten Sie einen Blick in die GNU Manual Seite + <ulink url="&url.gnu.man.date-input;">Date Input Formats</ulink> werfen. + Dort wird die gültige Syntax für <parameter>time</parameter> beschrieben. + </simpara> + <para> + <example> + <title><function>strtotime</function>-Beispiele:</title> + <programlisting role="php"> +<![CDATA[ +echo strtotime ("now"), "\n"; +echo strtotime ("10 September 2000"), "\n"; +echo strtotime ("+1 day"), "\n"; +echo strtotime ("+1 week"), "\n"; +echo strtotime ("+1 week 2 days 4 hours 2 seconds"), "\n"; +echo strtotime ("next Thursday"), "\n"; +echo strtotime ("last Monday"), "\n"; +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Fehlerüberprüfung</title> + <programlisting role="php"> +<![CDATA[ +$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> + </para> + <note> + <para> + Der gültige Bereich eines Timestamp liegt typischerweise zwischen + Fri, 13 Dec 1901 20:45:54 GMT und Tue, 19 Jan 2038 03:14:07 GMT. + (Das sind die Datumsangaben, die dem minimalen und maximalen Wert eines + vorzeichenbehafteten 32-bit Integer entsprechen.) + </para> + </note> + </refsect1> + </refentry> + + Index: phpdoc-de/reference/datetime/functions/strftime.xml diff -u phpdoc-de/reference/datetime/functions/strftime.xml:1.7 phpdoc-de/reference/datetime/functions/strftime.xml:1.8 --- phpdoc-de/reference/datetime/functions/strftime.xml:1.7 Sun Dec 1 16:12:00 2002 +++ phpdoc-de/reference/datetime/functions/strftime.xml Sun Dec 1 16:22:00 2002 @@ -1,288 +1,288 @@ -<?xml version="1.0" encoding="iso-8859-1"?> - - - - <refentry id="function.strftime"> - <refnamediv> - <refname>strftime</refname> - <refpurpose> - Formatiert eine Zeit-/Datumsangabe nach den lokalen Einstellungen - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>string</type><methodname>strftime</methodname> - <methodparam><type>string</type><parameter>format</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter> - Timestamp - </parameter></methodparam> - </methodsynopsis> - <para> - Gibt einen String zurück, der den angegebenen Formatierungs-Merkmalen - entspricht. Dabei wird der gegebene <parameter>Timestamp</parameter>/ - Zeitstempel oder - falls dieser fehlt - die momentane lokale Zeit benutzt. - Der Monats- und Wochentagsname wird entsprechend des per - <function>setlocale</function> eingestellten Wertes gesetzt. - </para> - <para> - Nachfolgend die im Formatierungsstring gültigen / bekannten - Platzhalter: - <itemizedlist> - <listitem> - <simpara> - %a - abgekürzter Name des Wochentages, abhängig von der - gesetzten Umgebung - </simpara> - </listitem> - <listitem> - <simpara> - %A - ausgeschriebener Name des Wochentages, abhängig von der - gesetzten Umgebung - </simpara> - </listitem> - <listitem> - <simpara> - %b - abgekürzter Name des Monats, abhängig von der gesetzten - Umgebung - </simpara> - </listitem> - <listitem> - <simpara> - %B - ausgeschriebener Name des Monats, abhängig von der - gesetzten Umgebung - </simpara> - </listitem> - <listitem> - <simpara> - %c - Wiedergabewerte für Datum und Zeit, abhängig von der - gesetzten Umgebung - </simpara> - </listitem> - <listitem> - <simpara> - %C - Jahrhundert (Jahr geteilt durch 100, gekürzt auf Integer, - Wertebereich 00 bis 99) - </simpara> - </listitem> - <listitem> - <simpara> - %d - Tag des Monats als Zahl (Bereich 00 bis 31) - </simpara> - </listitem> - <listitem> - <simpara> - %D - so wie %m/%d/%y - </simpara> - </listitem> - <listitem> - <simpara> - %e - Tag des Monats als Dezimal-Wert, einstelligen Werten wird - ein Leerzeichen voran gestellt (Wertebereich ´ 0´ bis ´31´) - </simpara> - </listitem> - <listitem> - <simpara> - %g - wie %G, aber ohne Jahrhundert. - </simpara> - </listitem> - <listitem> - <simpara> - %G - Das vierstellige Jahr entsprechend der ISO Wochennummer (siehe %V). - Das gleiche Format und der gleiche Wert wie bei %Y. Besonderheit: - entspricht die ISO Wochennummer dem vorhergehenden oder folgenden - Jahr, wird dieses Jahr verwendet. - </simpara> - </listitem> - <listitem> - <simpara> - %h - so wie %b - </simpara> - </listitem> - <listitem> - <simpara> - %H - Stunde als Zahl im 24-Stunden-Format (Bereich 00 bis 23) - </simpara> - </listitem> - <listitem> - <simpara> - %I - Stunde als Zahl im 12-Stunden-Format (Bereich 01 bis 12) - </simpara> - </listitem> - <listitem> - <simpara> - %j - Tag des Jahres als Zahl (Bereich 001 bis 366) - </simpara> - </listitem> - <listitem> - <simpara> - %m - Monat als Zahl (Bereich 01 bis 12) - </simpara> - </listitem> - <listitem> - <simpara> - %M - Minute als Dezimal-Wert - </simpara> - </listitem> - <listitem> - <simpara> - %n - neue Zeile - </simpara> - </listitem> - <listitem> - <simpara> - %p - entweder `am' oder `pm' (abhängig von der gesetzten - Umgebung) oder die entsprechenden Zeichenketten der gesetzten - Umgebung - </simpara> - </listitem> - <listitem> - <simpara> - %r - Zeit im Format a.m. oder p.m. - </simpara> - </listitem> - <listitem> - <simpara> - %R - Zeit in der 24-Stunden-Formatierung - </simpara> - </listitem> - <listitem> - <simpara> - %S - Sekunden als Dezimal-Wert - </simpara> - </listitem> - <listitem> - <simpara> - %t - Tabulator - </simpara> - </listitem> - <listitem> - <simpara> - %T - aktuelle Zeit, genau wie %H:%M:%S - </simpara> - </listitem> - <listitem> - <simpara> - %u - Tag der Woche als Dezimal-Wert [1,7], dabei ist 1 der Montag. - </simpara> - <warning> - <simpara> - Sun Solaris scheint mit dem Sonntag als 1 zu starten, - obwohl ISO 9889:1999 (der aktuelle C Standard) klar - festlegt, dass es der Montag sein sollte. - </simpara> - </warning> - </listitem> - <listitem> - <simpara> - %U - Nummer der Woche des aktuellen Jahres als Dezimal-Wert, - beginnend mit dem ersten Sonntag als erstem Tag der ersten Woche. - </simpara> - </listitem> - <listitem> - <simpara> - %V - Kalenderwoche (nach ISO 8601:1988) des aktuellen Jahres. - Als Dezimal-Zahl mit dem Wertebereich 01 bis 53, wobei die - Woche 01 die erste Woche mit mindestens 4 Tagen im aktuellen - Jahr ist. Die Woche beginnt montags (nicht sonntags). (Benutzen Sie - %G or %g für die Jahreskomponente, die der Wochennummer für den - gegebenen Timestamp entspricht.) - </simpara> - </listitem> - <listitem> - <simpara> - %w - Wochentag als Dezimal-Wert, Sonntag ist 0 - </simpara> - </listitem> - <listitem> - <simpara> - %W - Nummer der Woche des aktuellen Jahres, beginnend mit dem - ersten Montag als erstem Tag der ersten Woche. - </simpara> - </listitem> - <listitem> - <simpara> - %x - bevorzugte Datumswiedergabe (ohne Zeit), abhängig von der - gesetzten Umgebung. - </simpara> - </listitem> - <listitem> - <simpara> - %X - bevorzugte Zeitwiedergabe (ohne Datum), abhängig von der - gesetzten Umgebung. - </simpara> - </listitem> - <listitem> - <simpara> - %y - Jahr als 2-stellige-Zahl (Bereich 00 bis 99) - </simpara> - </listitem> - <listitem> - <simpara> - %Y - Jahr als 4-stellige-Zahl inklusive des Jahrhunderts - </simpara> - </listitem> - <listitem> - <simpara> - %Z - Zeitzone, Name oder eine Abkürzung - </simpara> - </listitem> - <listitem> - <simpara> - %% - ein %-Zeichen - </simpara> - </listitem> - </itemizedlist> - <note> - <para> - 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 und %D (vielleicht noch weitere) auf - Windowssystemen nicht funktionieren. - </para> - </note> - <example> - <title><function>strftime</function> Beispiel</title> - <programlisting role="php"> -setlocale (LC_TIME, "C"); -print (strftime ("%A in Finnland ist ")); -setlocale (LC_TIME, "fi_FI"); -print (strftime ("%A, in Frankreich ")); -setlocale (LC_TIME, "fr_FR"); -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> - <para> - Siehe auch <function>setlocale</function>, - <function>mktime</function> und die <ulink url="&spec.strftime;"> - Open Group Spezifikation von <function>strftime</function></ulink>. - </para> - </refsect1> - </refentry> - - +<?xml version="1.0" encoding="iso-8859-1"?> + + + + <refentry id="function.strftime"> + <refnamediv> + <refname>strftime</refname> + <refpurpose> + Formatiert eine Zeit-/Datumsangabe nach den lokalen Einstellungen + </refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung:</title> + <methodsynopsis> + <type>string</type><methodname>strftime</methodname> + <methodparam><type>string</type><parameter>format</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter> + Timestamp + </parameter></methodparam> + </methodsynopsis> + <para> + Gibt einen String zurück, der den angegebenen Formatierungs-Merkmalen + entspricht. Dabei wird der gegebene <parameter>Timestamp</parameter>/ + Zeitstempel oder - falls dieser fehlt - die momentane lokale Zeit benutzt. + Der Monats- und Wochentagsname wird entsprechend des per + <function>setlocale</function> eingestellten Wertes gesetzt. + </para> + <para> + Nachfolgend die im Formatierungsstring gültigen / bekannten + Platzhalter: + <itemizedlist> + <listitem> + <simpara> + %a - abgekürzter Name des Wochentages, abhängig von der + gesetzten Umgebung + </simpara> + </listitem> + <listitem> + <simpara> + %A - ausgeschriebener Name des Wochentages, abhängig von der + gesetzten Umgebung + </simpara> + </listitem> + <listitem> + <simpara> + %b - abgekürzter Name des Monats, abhängig von der gesetzten + Umgebung + </simpara> + </listitem> + <listitem> + <simpara> + %B - ausgeschriebener Name des Monats, abhängig von der + gesetzten Umgebung + </simpara> + </listitem> + <listitem> + <simpara> + %c - Wiedergabewerte für Datum und Zeit, abhängig von der + gesetzten Umgebung + </simpara> + </listitem> + <listitem> + <simpara> + %C - Jahrhundert (Jahr geteilt durch 100, gekürzt auf Integer, + Wertebereich 00 bis 99) + </simpara> + </listitem> + <listitem> + <simpara> + %d - Tag des Monats als Zahl (Bereich 00 bis 31) + </simpara> + </listitem> + <listitem> + <simpara> + %D - so wie %m/%d/%y + </simpara> + </listitem> + <listitem> + <simpara> + %e - Tag des Monats als Dezimal-Wert, einstelligen Werten wird + ein Leerzeichen voran gestellt (Wertebereich ´ 0´ bis ´31´) + </simpara> + </listitem> + <listitem> + <simpara> + %g - wie %G, aber ohne Jahrhundert. + </simpara> + </listitem> + <listitem> + <simpara> + %G - Das vierstellige Jahr entsprechend der ISO Wochennummer (siehe %V). + Das gleiche Format und der gleiche Wert wie bei %Y. Besonderheit: + entspricht die ISO Wochennummer dem vorhergehenden oder folgenden + Jahr, wird dieses Jahr verwendet. + </simpara> + </listitem> + <listitem> + <simpara> + %h - so wie %b + </simpara> + </listitem> + <listitem> + <simpara> + %H - Stunde als Zahl im 24-Stunden-Format (Bereich 00 bis 23) + </simpara> + </listitem> + <listitem> + <simpara> + %I - Stunde als Zahl im 12-Stunden-Format (Bereich 01 bis 12) + </simpara> + </listitem> + <listitem> + <simpara> + %j - Tag des Jahres als Zahl (Bereich 001 bis 366) + </simpara> + </listitem> + <listitem> + <simpara> + %m - Monat als Zahl (Bereich 01 bis 12) + </simpara> + </listitem> + <listitem> + <simpara> + %M - Minute als Dezimal-Wert + </simpara> + </listitem> + <listitem> + <simpara> + %n - neue Zeile + </simpara> + </listitem> + <listitem> + <simpara> + %p - entweder `am' oder `pm' (abhängig von der gesetzten + Umgebung) oder die entsprechenden Zeichenketten der gesetzten + Umgebung + </simpara> + </listitem> + <listitem> + <simpara> + %r - Zeit im Format a.m. oder p.m. + </simpara> + </listitem> + <listitem> + <simpara> + %R - Zeit in der 24-Stunden-Formatierung + </simpara> + </listitem> + <listitem> + <simpara> + %S - Sekunden als Dezimal-Wert + </simpara> + </listitem> + <listitem> + <simpara> + %t - Tabulator + </simpara> + </listitem> + <listitem> + <simpara> + %T - aktuelle Zeit, genau wie %H:%M:%S + </simpara> + </listitem> + <listitem> + <simpara> + %u - Tag der Woche als Dezimal-Wert [1,7], dabei ist 1 der Montag. + </simpara> + <warning> + <simpara> + Sun Solaris scheint mit dem Sonntag als 1 zu starten, + obwohl ISO 9889:1999 (der aktuelle C Standard) klar + festlegt, dass es der Montag sein sollte. + </simpara> + </warning> + </listitem> + <listitem> + <simpara> + %U - Nummer der Woche des aktuellen Jahres als Dezimal-Wert, + beginnend mit dem ersten Sonntag als erstem Tag der ersten Woche. + </simpara> + </listitem> + <listitem> + <simpara> + %V - Kalenderwoche (nach ISO 8601:1988) des aktuellen Jahres. + Als Dezimal-Zahl mit dem Wertebereich 01 bis 53, wobei die + Woche 01 die erste Woche mit mindestens 4 Tagen im aktuellen + Jahr ist. Die Woche beginnt montags (nicht sonntags). (Benutzen Sie + %G or %g für die Jahreskomponente, die der Wochennummer für den + gegebenen Timestamp entspricht.) + </simpara> + </listitem> + <listitem> + <simpara> + %w - Wochentag als Dezimal-Wert, Sonntag ist 0 + </simpara> + </listitem> + <listitem> + <simpara> + %W - Nummer der Woche des aktuellen Jahres, beginnend mit dem + ersten Montag als erstem Tag der ersten Woche. + </simpara> + </listitem> + <listitem> + <simpara> + %x - bevorzugte Datumswiedergabe (ohne Zeit), abhängig von der + gesetzten Umgebung. + </simpara> + </listitem> + <listitem> + <simpara> + %X - bevorzugte Zeitwiedergabe (ohne Datum), abhängig von der + gesetzten Umgebung. + </simpara> + </listitem> + <listitem> + <simpara> + %y - Jahr als 2-stellige-Zahl (Bereich 00 bis 99) + </simpara> + </listitem> + <listitem> + <simpara> + %Y - Jahr als 4-stellige-Zahl inklusive des Jahrhunderts + </simpara> + </listitem> + <listitem> + <simpara> + %Z - Zeitzone, Name oder eine Abkürzung + </simpara> + </listitem> + <listitem> + <simpara> + %% - ein %-Zeichen + </simpara> + </listitem> + </itemizedlist> + <note> + <para> + 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 und %D (vielleicht noch weitere) auf + Windowssystemen nicht funktionieren. + </para> + </note> + <example> + <title><function>strftime</function> Beispiel</title> + <programlisting role="php"> +setlocale (LC_TIME, "C"); +print (strftime ("%A in Finnland ist ")); +setlocale (LC_TIME, "fi_FI"); +print (strftime ("%A, in Frankreich ")); +setlocale (LC_TIME, "fr_FR"); +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> + <para> + Siehe auch <function>setlocale</function>, + <function>mktime</function> und die <ulink url="&spec.strftime;"> + Open Group Spezifikation von <function>strftime</function></ulink>. + </para> + </refsect1> + </refentry> + + Index: phpdoc-de/reference/datetime/functions/mktime.xml diff -u phpdoc-de/reference/datetime/functions/mktime.xml:1.5 phpdoc-de/reference/datetime/functions/mktime.xml:1.6 --- phpdoc-de/reference/datetime/functions/mktime.xml:1.5 Sun Dec 1 16:12:00 2002 +++ phpdoc-de/reference/datetime/functions/mktime.xml Sun Dec 1 16:22:00 2002 @@ -1,123 +1,123 @@ -<?xml version="1.0" encoding="iso-8859-1"?> - - - - <refentry id="function.mktime"> - <refnamediv> - <refname>mktime</refname> - <refpurpose> - Gibt den UNIX-Timestamp/Zeitstempel für ein Datum zurück - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>int</type><methodname>mktime</methodname> - <methodparam><type>int</type><parameter>Stunde</parameter></methodparam> - <methodparam><type>int</type><parameter>Minute</parameter></methodparam> - <methodparam><type>int</type><parameter>Sekunde</parameter></methodparam> - <methodparam><type>int</type><parameter>Monat</parameter></methodparam> - <methodparam><type>int</type><parameter>Tag</parameter></methodparam> - <methodparam><type>int</type><parameter>Jahr</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>is_dst</parameter></methodparam> - </methodsynopsis> - <para> - <emphasis>Warnung:</emphasis> Beachten sie die andersartige - Anordnung der Argumente. Diese unterscheidet sich von der - Reihenfolge des UNIX-Befehls mktime(). Das ist eine häufige - Fehlerursache in Scripts. - </para> - <para> - Gibt den UNIX Timestamp/Zeitstempel an Hand der gegebenen - Argumente zurück. Der Zeitstempel ist ein long-integer-Wert, der - die Anzahl der Sekunden zwischen der UNIX Epoche (January 1 1970) und - der angegebenen Zeit enthält. - </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. - </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, versucht PHP selbst dies herauszufinden. Das kann zu - unerwarteten (aber richtigen) Ergebnissen führen. - </para> - <note> - <para> - <parameter>is_dst</parameter> wurde in 3.0.10. eingeführt. - </para> - </note> - <para> - <function>mktime</function> ist hilfreich bei Datumsberechnungen - und -überprüfungen, da automatisch das korrekte Datum für ungültige - Angaben berechnet wird. So wird in den folgenden Beispielen immer die - Zeichenkette "Jan-01-1998" ausgegeben. - <example> - <title><function>mktime</function> Beispiel</title> - <programlisting> -<![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> - 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). - </para> - <para> - Der letzte Tag eines gegebenen Monats kann als der Tag "0" des - nächsten Monats ausgedrückt werden (nicht als der Tag - "-1"). Jedes der folgenden Beispiele gibt die Zeichenkette - "Letzter Tag im Feb. 2000 ist der 29." zurück. - <example> - <title>Letzter Tag des nächsten Monats</title> - <programlisting> -$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> - <simpara> - Datumsangaben, bei denen das Jahr, der Monat und Tag gleich Null - sind, werden als ungültig angesehen (ansonsten als 30.11.1999, was - nicht gewollt sein kann). - </simpara> - <para> - Siehe auch <function>date</function> und - <function>time</function>. - </para> - </refsect1> - </refentry> - - +<?xml version="1.0" encoding="iso-8859-1"?> + + + + <refentry id="function.mktime"> + <refnamediv> + <refname>mktime</refname> + <refpurpose> + Gibt den UNIX-Timestamp/Zeitstempel für ein Datum zurück + </refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung:</title> + <methodsynopsis> + <type>int</type><methodname>mktime</methodname> + <methodparam><type>int</type><parameter>Stunde</parameter></methodparam> + <methodparam><type>int</type><parameter>Minute</parameter></methodparam> + <methodparam><type>int</type><parameter>Sekunde</parameter></methodparam> + <methodparam><type>int</type><parameter>Monat</parameter></methodparam> + <methodparam><type>int</type><parameter>Tag</parameter></methodparam> + <methodparam><type>int</type><parameter>Jahr</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>is_dst</parameter></methodparam> + </methodsynopsis> + <para> + <emphasis>Warnung:</emphasis> Beachten sie die andersartige + Anordnung der Argumente. Diese unterscheidet sich von der + Reihenfolge des UNIX-Befehls mktime(). Das ist eine häufige + Fehlerursache in Scripts. + </para> + <para> + Gibt den UNIX Timestamp/Zeitstempel an Hand der gegebenen + Argumente zurück. Der Zeitstempel ist ein long-integer-Wert, der + die Anzahl der Sekunden zwischen der UNIX Epoche (January 1 1970) und + der angegebenen Zeit enthält. + </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. + </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, versucht PHP selbst dies herauszufinden. Das kann zu + unerwarteten (aber richtigen) Ergebnissen führen. + </para> + <note> + <para> + <parameter>is_dst</parameter> wurde in 3.0.10. eingeführt. + </para> + </note> + <para> + <function>mktime</function> ist hilfreich bei Datumsberechnungen + und -überprüfungen, da automatisch das korrekte Datum für ungültige + Angaben berechnet wird. So wird in den folgenden Beispielen immer die + Zeichenkette "Jan-01-1998" ausgegeben. + <example> + <title><function>mktime</function> Beispiel</title> + <programlisting> +<![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> + 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). + </para> + <para> + Der letzte Tag eines gegebenen Monats kann als der Tag "0" des + nächsten Monats ausgedrückt werden (nicht als der Tag + "-1"). Jedes der folgenden Beispiele gibt die Zeichenkette + "Letzter Tag im Feb. 2000 ist der 29." zurück. + <example> + <title>Letzter Tag des nächsten Monats</title> + <programlisting> +$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> + <simpara> + Datumsangaben, bei denen das Jahr, der Monat und Tag gleich Null + sind, werden als ungültig angesehen (ansonsten als 30.11.1999, was + nicht gewollt sein kann). + </simpara> + <para> + Siehe auch <function>date</function> und + <function>time</function>. + </para> + </refsect1> + </refentry> + + Index: phpdoc-de/reference/datetime/functions/gmdate.xml diff -u phpdoc-de/reference/datetime/functions/gmdate.xml:1.5 phpdoc-de/reference/datetime/functions/gmdate.xml:1.6 --- phpdoc-de/reference/datetime/functions/gmdate.xml:1.5 Sun Dec 1 16:12:00 2002 +++ phpdoc-de/reference/datetime/functions/gmdate.xml Sun Dec 1 16:22:00 2002 @@ -1,61 +1,61 @@ -<?xml version="1.0" encoding="iso-8859-1"?> - - - - <refentry id="function.gmdate"> - <refnamediv> - <refname>gmdate</refname> - <refpurpose>Formatiert eine GMT/CUT Zeit- Datumsangabe</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>string</type><methodname>gmdate</methodname> - <methodparam><type>string</type><parameter>Format</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>Timestamp</parameter></methodparam> - </methodsynopsis> - <para> - Entspricht der <function>date</function> Funktion, außer dass als - Zeitangabe immer Greenwich Mean Time (GMT) zurück gegeben - wird. Steht ihr System in Deutschland (GMT + 01:00), wird im - Beispiel unten (1. Zeile) "Jan 01 1998 00:00:00" ausgegeben, - wogegen die 2. Zeile "Dec 31 1997 23:00:00" zurück gibt. - <example> - <title><function>gmdate</function> Beispiel</title> - <programlisting role="php"> -<![CDATA[ -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> - <para> - Siehe auch: <function>date</function>, - <function>mktime</function>, - <function>gmmktime</function> und - <function>strftime</function>. - </para> - </refsect1> - </refentry> - - +<?xml version="1.0" encoding="iso-8859-1"?> + + + + <refentry id="function.gmdate"> + <refnamediv> + <refname>gmdate</refname> + <refpurpose>Formatiert eine GMT/CUT Zeit- Datumsangabe</refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung:</title> + <methodsynopsis> + <type>string</type><methodname>gmdate</methodname> + <methodparam><type>string</type><parameter>Format</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>Timestamp</parameter></methodparam> + </methodsynopsis> + <para> + Entspricht der <function>date</function> Funktion, außer dass als + Zeitangabe immer Greenwich Mean Time (GMT) zurück gegeben + wird. Steht ihr System in Deutschland (GMT + 01:00), wird im + Beispiel unten (1. Zeile) "Jan 01 1998 00:00:00" ausgegeben, + wogegen die 2. Zeile "Dec 31 1997 23:00:00" zurück gibt. + <example> + <title><function>gmdate</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +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> + <para> + Siehe auch: <function>date</function>, + <function>mktime</function>, + <function>gmmktime</function> und + <function>strftime</function>. + </para> + </refsect1> + </refentry> + + Index: phpdoc-de/reference/datetime/functions/checkdate.xml diff -u phpdoc-de/reference/datetime/functions/checkdate.xml:1.6 phpdoc-de/reference/datetime/functions/checkdate.xml:1.7 --- phpdoc-de/reference/datetime/functions/checkdate.xml:1.6 Sun Dec 1 16:12:00 2002 +++ phpdoc-de/reference/datetime/functions/checkdate.xml Sun Dec 1 16:22:00 2002 @@ -1,69 +1,69 @@ -<?xml version="1.0" encoding="iso-8859-1"?> - - - - <refentry id="function.checkdate"> - <refnamediv> - <refname>checkdate</refname> - <refpurpose> - Prüft ein gregorianisches Datum auf Gültigkeit - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>bool</type><methodname>checkdate</methodname> - <methodparam><type>int</type><parameter>Monat</parameter></methodparam> - <methodparam><type>int</type><parameter>Tag</parameter></methodparam> - <methodparam><type>int</type><parameter>Jahr</parameter></methodparam> - </methodsynopsis> - <para> - Ist das angegebene Datum gültig, wird &true; zurückgegeben, ansonsten - &false;. Prüft die Gültigkeit der angebenen Datumswerte. Ein Datum wird - als gültig angesehen, wenn - <itemizedlist> - <listitem> - <simpara> - das Jahr zwischen 1 und 32767 (inklusive) ist, - </simpara> - </listitem> - <listitem> - <simpara> - der Monat zwischen 1 und 12 (inklusive) ist und - </simpara> - </listitem> - <listitem> - <simpara> - der <parameter>Tag</parameter> innerhalb der erlaubten Werte des angegebenen - <parameter>Monat</parameter>s ist. Schalt<parameter>Jahre</parameter> - werden berücksichtigt. - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - Siehe auch <function>mktime</function> und <function>strtotime</function>. - </para> - </refsect1> - </refentry> - - +<?xml version="1.0" encoding="iso-8859-1"?> + + + + <refentry id="function.checkdate"> + <refnamediv> + <refname>checkdate</refname> + <refpurpose> + Prüft ein gregorianisches Datum auf Gültigkeit + </refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung:</title> + <methodsynopsis> + <type>bool</type><methodname>checkdate</methodname> + <methodparam><type>int</type><parameter>Monat</parameter></methodparam> + <methodparam><type>int</type><parameter>Tag</parameter></methodparam> + <methodparam><type>int</type><parameter>Jahr</parameter></methodparam> + </methodsynopsis> + <para> + Ist das angegebene Datum gültig, wird &true; zurückgegeben, ansonsten + &false;. Prüft die Gültigkeit der angebenen Datumswerte. Ein Datum wird + als gültig angesehen, wenn + <itemizedlist> + <listitem> + <simpara> + das Jahr zwischen 1 und 32767 (inklusive) ist, + </simpara> + </listitem> + <listitem> + <simpara> + der Monat zwischen 1 und 12 (inklusive) ist und + </simpara> + </listitem> + <listitem> + <simpara> + der <parameter>Tag</parameter> innerhalb der erlaubten Werte des angegebenen + <parameter>Monat</parameter>s ist. Schalt<parameter>Jahre</parameter> + werden berücksichtigt. + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + Siehe auch <function>mktime</function> und <function>strtotime</function>. + </para> + </refsect1> + </refentry> + +

cvs: phpdoc-de /reference/datetime reference.xml /reference/datetime/functions checkdate.xml date.xml gmdate.xml mktime.xml strftime.xml strtotime.xml

cvs: phpdoc-de /reference/datetime reference.xml /reference/datetime/functions checkdate.xml date.xml gmdate.xml mktime.xml strftime.xml
strtotime.xml