cvs: phpdoc-de /reference/datetime/functions strtotime.xml time.xml
| From: | Carola 'Sammy' Kummert | Date: | Tue, 05 Aug 2008 20:50:52 +0000 |
| Subject: | cvs: phpdoc-de /reference/datetime/functions strtotime.xml time.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2738@lists.php.net to get a copy of this message | ||
sammywg Tue Aug 5 20:50:52 2008 UTC
Modified files:
/phpdoc-de/reference/datetime/functions strtotime.xml time.xml
Log:
sync to en
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/datetime/functions/strtotime.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-de/reference/datetime/functions/strtotime.xml diff -u phpdoc-de/reference/datetime/functions/strtotime.xml:1.11 phpdoc-de/reference/datetime/functions/strtotime.xml:1.12 --- phpdoc-de/reference/datetime/functions/strtotime.xml:1.11 Wed Jun 18 00:08:57 2008 +++ phpdoc-de/reference/datetime/functions/strtotime.xml Tue Aug 5 20:50:52 2008 @@ -1,40 +1,121 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.7 Maintainer: nobody Status: ready --> - - <refentry xml:id="function.strtotime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <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 - umzuwandeln. 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 - <link xlink:href="&url.gnu.man.date-input;">Date Input Formats</link> 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"> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.25 Maintainer: sammywg Status: ready --> + +<refentry xml:id="function.strtotime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>strtotime</refname> + <refpurpose>Wandelt ein beliebiges in englischer Textform angegebenes Datum + in einen UNIX-Zeitstempel (Timestamp) um</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <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 in US-englischem + Datumsformat und versucht, dieses Format in einen Unix-Timestamp (die Anzahl + der Sekunden seit dem 01. Januar 1970 00:00:00 GMT) zu übersetzen. Die Angabe + wird relativ zum im <parameter>now</parameter>-Parameter übergebenen + Timestamp oder der aktuellen Zeit, sofern <parameter>now</parameter> nicht + unterstützt wird, ausgewertet. + </simpara> + <para> + Die Funktion verwendet, sofern diese verfügbar ist, die + <envar>TZ</envar>-Umgebungsvariable um den Timestamp zu berechnen. Seit + PHP 5.1.0 gibt es einfachere Wege, die zu verwendende Zeitzone festzulegen, + die mit allen Datums- und Zeitfunktionen verwendet werden soll. + Ausführlichere Erklärungen dazu finden Sie auf der + <function>date_default_timezone_get</function>-Manualseite. + </para> + <note> + <para> + Wenn die Jahreszahlenangabe zweistellig erfolgt, werden Werte zwischen 00 + und 69 auf die Jahre 2000 bis 2069 gemappt, die Werte 70-99 ergeben die + Jahreszahlen 1970-1999. + </para> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>time</parameter></term> + <listitem> + <para> + Die zu parsende Zeichenkette entsprechend der GNU <link + xlink:href="&url.gnu.man.date-input;">Datumseingabeformat</link>-Syntax. + Vor PHP 5.0.0 war die Angabe von Mikrosekunden in einer Zeitangabe + nicht erlaubt, seit PHP 5.0.0 ist dies erlaubt, wird aber ignoriert. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>now</parameter></term> + <listitem> + <para> + Der Timestamp, der für die Berechnung des Rückgabewertes verwendet wird. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt im Erfolgsfall einen Timestamp, andernfalls &false; zurück. Vor PHP 5.1.0 + gab die Funktion <literal>-1</literal> im Fehlerfall zurück. + </para> + </refsect1> + + <refsect1 role="errors"> + &reftitle.errors; + + &date.timezone.errors.description; + + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.1.0</entry> + <entry> + Die Funktion gibt nun statt <literal>-1</literal> im Fehlerfall &false; + zurück. + </entry> + </row> + + &date.timezone.errors.changelog; + + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Ein <function>strtotime</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php echo strtotime("now"), "\n"; @@ -46,42 +127,73 @@ echo strtotime("last Monday"), "\n"; ?> ]]> - </programlisting> - </example> - </para> - <para> - <example> - <title>Fehlerüberprüfung</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + <example> + <title>Test auf Fehler</title> + <programlisting role="php"> <![CDATA[ <?php -$str = 'Nicht gut'; -if (($timestamp = strtotime($str)) === -1) { - echo "Der String ($str) ist falsch."; +$str = 'Not Good'; + +// vor PHP 5.1.0 wuerden Sie -1 statt false als Rueckgabewert erhalten +if (($timestamp = strtotime($str)) === false) { + echo "Die Zeichenkette ($str) ist nicht parsebar."; } else { - echo "$str == " . date('l dS of F Y h:i:s A', $timestamp); + echo "$str == " . date('l dS \o\f 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.) Zusätzlich - unterstützen nicht alle Plattformen negative Werte eines Timestamps, - deshalb könnte der Wertebereich eines Datums durch den Beginn der Unix - Epoche begrenzt sein. Das bedeutet, dass z.B. Zeitangaben vor dem - <literal>Jan 1, 1970</literal> auf Windowssystemen, einigen - Linuxdisrtibutionen und einigen anderen Betriebssytemen nicht - funktionieren. - </para> - </note> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <warning> + <para> + In PHP 5 bis 5.0.2 werden <literal>"now"</literal> und andere relative + Zeitangaben fälschlicherweise dem Zeitpunkt des Datumswechsels zugeordnet. + Dieses Verhalten unterscheidet sich von anderen Versionen, die diese + Angaben in die korrekte aktuelle Zeit übersetzen. + </para> + </warning> + <warning> + <para> + In PHP-Versionen vor 4.4.0 wird <literal>"next"</literal> fälschlicherweise + als +2 interpretiert. Eine einfache Lösung für dieses Problem ist, explizit + <literal>+1</literal> zu verwenden. + </para> + </warning> + <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.) Zusätzlich + unterstützen nicht alle Plattformen negative Werte eines Timestamps, + deshalb könnte der Wertebereich eines Datums durch den Beginn der Unix + Epoche begrenzt sein. Das bedeutet, dass z.B. Zeitangaben vor dem + <literal>01. Januar 1970</literal> auf Windowssystemen, einigen + Linuxdistributionen und einigen anderen Betriebssytemen nicht + funktionieren. Die PHP-Versionen 5.1.0 und neuer heben diese Beschränkung + auf. + </para> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strptime</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/datetime/functions/time.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/datetime/functions/time.xml diff -u phpdoc-de/reference/datetime/functions/time.xml:1.9 phpdoc-de/reference/datetime/functions/time.xml:1.10 --- phpdoc-de/reference/datetime/functions/time.xml:1.9 Wed Jun 18 00:08:57 2008 +++ phpdoc-de/reference/datetime/functions/time.xml Tue Aug 5 20:50:52 2008 @@ -1,29 +1,75 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.4 Maintainer: nobody Status: ready --> - - <refentry xml:id="function.time" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>time</refname> - <refpurpose> - Gibt den gegenwärtigen Unix-Timestamp/Zeitstempel zurück - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>time</methodname> - <void/> - </methodsynopsis> - <para> - Gibt die seit Beginn der Unix-Epoche (Januar 1 1970 00:00:00 GMT) - bis jetzt vergangenen Sekunden zurück. - </para> - <para> - Siehe auch <function>date</function> und <function>microtime</function>. - </para> - </refsect1> - </refentry> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.10 Maintainer: sammywg Status: ready --> + +<refentry xml:id="function.time" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>time</refname> + <refpurpose>Gibt den aktuellen Unix-Timestamp/Zeitstempel zurück</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>time</methodname> + <void/> + </methodsynopsis> + <para> + Gibt die seit Beginn der Unix-Epoche (Januar 1 1970 00:00:00 GMT) + bis jetzt vergangenen Sekunden zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>time</function>-Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php +$nextWeek = time() + (7 * 24 * 60 * 60); + // 7 Tage; 24 Stunden; 60 Minuten; 60 Sekunden +echo 'Jetzt: '. date('Y-m-d') ."\n"; +echo 'Naechste Woche: '. date('Y-m-d', $nextWeek) ."\n"; +// oder strtotime() verwenden: +echo 'Naechste Woche: '. date('Y-m-d', strtotime('+1 week')) ."\n"; +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Jetzt: 2005-03-30 +Naechste Woche: 2005-04-06 +Naechste Woche: 2005-04-06 +]]> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <tip> + <para> + Der Timestamp des Beginns der aktuellen Anfrage steht seit PHP 5.1 + in der Variablen <varname>$_SERVER['REQUEST_TIME']</varname> zur Verfügung. + </para> + </tip> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>date</function></member> + <member><function>microtime</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables:
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/datetime/functions/strtotime.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-de/reference/datetime/functions/strtotime.xml diff -u phpdoc-de/reference/datetime/functions/strtotime.xml:1.11 phpdoc-de/reference/datetime/functions/strtotime.xml:1.12 --- phpdoc-de/reference/datetime/functions/strtotime.xml:1.11 Wed Jun 18 00:08:57 2008 +++ phpdoc-de/reference/datetime/functions/strtotime.xml Tue Aug 5 20:50:52 2008 @@ -1,40 +1,121 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.7 Maintainer: nobody Status: ready --> - - <refentry xml:id="function.strtotime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <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 - umzuwandeln. 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 - <link xlink:href="&url.gnu.man.date-input;">Date Input Formats</link> 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"> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.25 Maintainer: sammywg Status: ready --> + +<refentry xml:id="function.strtotime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>strtotime</refname> + <refpurpose>Wandelt ein beliebiges in englischer Textform angegebenes Datum + in einen UNIX-Zeitstempel (Timestamp) um</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <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 in US-englischem + Datumsformat und versucht, dieses Format in einen Unix-Timestamp (die Anzahl + der Sekunden seit dem 01. Januar 1970 00:00:00 GMT) zu übersetzen. Die Angabe + wird relativ zum im <parameter>now</parameter>-Parameter übergebenen + Timestamp oder der aktuellen Zeit, sofern <parameter>now</parameter> nicht + unterstützt wird, ausgewertet. + </simpara> + <para> + Die Funktion verwendet, sofern diese verfügbar ist, die + <envar>TZ</envar>-Umgebungsvariable um den Timestamp zu berechnen. Seit + PHP 5.1.0 gibt es einfachere Wege, die zu verwendende Zeitzone festzulegen, + die mit allen Datums- und Zeitfunktionen verwendet werden soll. + Ausführlichere Erklärungen dazu finden Sie auf der + <function>date_default_timezone_get</function>-Manualseite. + </para> + <note> + <para> + Wenn die Jahreszahlenangabe zweistellig erfolgt, werden Werte zwischen 00 + und 69 auf die Jahre 2000 bis 2069 gemappt, die Werte 70-99 ergeben die + Jahreszahlen 1970-1999. + </para> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>time</parameter></term> + <listitem> + <para> + Die zu parsende Zeichenkette entsprechend der GNU <link + xlink:href="&url.gnu.man.date-input;">Datumseingabeformat</link>-Syntax. + Vor PHP 5.0.0 war die Angabe von Mikrosekunden in einer Zeitangabe + nicht erlaubt, seit PHP 5.0.0 ist dies erlaubt, wird aber ignoriert. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>now</parameter></term> + <listitem> + <para> + Der Timestamp, der für die Berechnung des Rückgabewertes verwendet wird. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt im Erfolgsfall einen Timestamp, andernfalls &false; zurück. Vor PHP 5.1.0 + gab die Funktion <literal>-1</literal> im Fehlerfall zurück. + </para> + </refsect1> + + <refsect1 role="errors"> + &reftitle.errors; + + &date.timezone.errors.description; + + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.1.0</entry> + <entry> + Die Funktion gibt nun statt <literal>-1</literal> im Fehlerfall &false; + zurück. + </entry> + </row> + + &date.timezone.errors.changelog; + + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Ein <function>strtotime</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php echo strtotime("now"), "\n"; @@ -46,42 +127,73 @@ echo strtotime("last Monday"), "\n"; ?> ]]> - </programlisting> - </example> - </para> - <para> - <example> - <title>Fehlerüberprüfung</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + <example> + <title>Test auf Fehler</title> + <programlisting role="php"> <![CDATA[ <?php -$str = 'Nicht gut'; -if (($timestamp = strtotime($str)) === -1) { - echo "Der String ($str) ist falsch."; +$str = 'Not Good'; + +// vor PHP 5.1.0 wuerden Sie -1 statt false als Rueckgabewert erhalten +if (($timestamp = strtotime($str)) === false) { + echo "Die Zeichenkette ($str) ist nicht parsebar."; } else { - echo "$str == " . date('l dS of F Y h:i:s A', $timestamp); + echo "$str == " . date('l dS \o\f 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.) Zusätzlich - unterstützen nicht alle Plattformen negative Werte eines Timestamps, - deshalb könnte der Wertebereich eines Datums durch den Beginn der Unix - Epoche begrenzt sein. Das bedeutet, dass z.B. Zeitangaben vor dem - <literal>Jan 1, 1970</literal> auf Windowssystemen, einigen - Linuxdisrtibutionen und einigen anderen Betriebssytemen nicht - funktionieren. - </para> - </note> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <warning> + <para> + In PHP 5 bis 5.0.2 werden <literal>"now"</literal> und andere relative + Zeitangaben fälschlicherweise dem Zeitpunkt des Datumswechsels zugeordnet. + Dieses Verhalten unterscheidet sich von anderen Versionen, die diese + Angaben in die korrekte aktuelle Zeit übersetzen. + </para> + </warning> + <warning> + <para> + In PHP-Versionen vor 4.4.0 wird <literal>"next"</literal> fälschlicherweise + als +2 interpretiert. Eine einfache Lösung für dieses Problem ist, explizit + <literal>+1</literal> zu verwenden. + </para> + </warning> + <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.) Zusätzlich + unterstützen nicht alle Plattformen negative Werte eines Timestamps, + deshalb könnte der Wertebereich eines Datums durch den Beginn der Unix + Epoche begrenzt sein. Das bedeutet, dass z.B. Zeitangaben vor dem + <literal>01. Januar 1970</literal> auf Windowssystemen, einigen + Linuxdistributionen und einigen anderen Betriebssytemen nicht + funktionieren. Die PHP-Versionen 5.1.0 und neuer heben diese Beschränkung + auf. + </para> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strptime</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/datetime/functions/time.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/datetime/functions/time.xml diff -u phpdoc-de/reference/datetime/functions/time.xml:1.9 phpdoc-de/reference/datetime/functions/time.xml:1.10 --- phpdoc-de/reference/datetime/functions/time.xml:1.9 Wed Jun 18 00:08:57 2008 +++ phpdoc-de/reference/datetime/functions/time.xml Tue Aug 5 20:50:52 2008 @@ -1,29 +1,75 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.4 Maintainer: nobody Status: ready --> - - <refentry xml:id="function.time" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>time</refname> - <refpurpose> - Gibt den gegenwärtigen Unix-Timestamp/Zeitstempel zurück - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>time</methodname> - <void/> - </methodsynopsis> - <para> - Gibt die seit Beginn der Unix-Epoche (Januar 1 1970 00:00:00 GMT) - bis jetzt vergangenen Sekunden zurück. - </para> - <para> - Siehe auch <function>date</function> und <function>microtime</function>. - </para> - </refsect1> - </refentry> +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.10 Maintainer: sammywg Status: ready --> + +<refentry xml:id="function.time" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>time</refname> + <refpurpose>Gibt den aktuellen Unix-Timestamp/Zeitstempel zurück</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>time</methodname> + <void/> + </methodsynopsis> + <para> + Gibt die seit Beginn der Unix-Epoche (Januar 1 1970 00:00:00 GMT) + bis jetzt vergangenen Sekunden zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>time</function>-Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php +$nextWeek = time() + (7 * 24 * 60 * 60); + // 7 Tage; 24 Stunden; 60 Minuten; 60 Sekunden +echo 'Jetzt: '. date('Y-m-d') ."\n"; +echo 'Naechste Woche: '. date('Y-m-d', $nextWeek) ."\n"; +// oder strtotime() verwenden: +echo 'Naechste Woche: '. date('Y-m-d', strtotime('+1 week')) ."\n"; +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Jetzt: 2005-03-30 +Naechste Woche: 2005-04-06 +Naechste Woche: 2005-04-06 +]]> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <tip> + <para> + Der Timestamp des Beginns der aktuellen Anfrage steht seit PHP 5.1 + in der Variablen <varname>$_SERVER['REQUEST_TIME']</varname> zur Verfügung. + </para> + </tip> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>date</function></member> + <member><function>microtime</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: