svn: /phpdoc/de/trunk/reference/datetime/functions/ date.xml getdate.xml gettimeofday.xml gmdate.xml localtime.xml microtime.xml strtotime.xml

[email protected] (Nikita Popov)
Newsgroups php.doc.de
Message-ID <[email protected]>
nikic                                    Fri, 01 Jul 2011 11:46:56 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=312763

Log:
Sync some DE datetime docs to EN

Changed paths:
    U   phpdoc/de/trunk/reference/datetime/functions/date.xml
    U   phpdoc/de/trunk/reference/datetime/functions/getdate.xml
    U   phpdoc/de/trunk/reference/datetime/functions/gettimeofday.xml
    U   phpdoc/de/trunk/reference/datetime/functions/gmdate.xml
    U   phpdoc/de/trunk/reference/datetime/functions/localtime.xml
    U   phpdoc/de/trunk/reference/datetime/functions/microtime.xml
    U   phpdoc/de/trunk/reference/datetime/functions/strtotime.xml
svn-diffs-312763.txt (text/x-diff, 12.8 KB)
Modified: phpdoc/de/trunk/reference/datetime/functions/date.xml
===================================================================
--- phpdoc/de/trunk/reference/datetime/functions/date.xml	2011-07-01 11:15:24 UTC (rev 312762)
+++ phpdoc/de/trunk/reference/datetime/functions/date.xml	2011-07-01 11:46:56 UTC (rev 312763)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: simp Status: ready -->
+<!-- EN-Revision: 312626 Maintainer: simp Status: ready -->
 <!-- Credits: sammywg -->
 <refentry xml:id="function.date" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -13,7 +13,7 @@
   <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>
+   <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter><initializer>time()</initializer></methodparam>
   </methodsynopsis>
   <para>
    Gibt einen formatierten String anhand eines vorzugebenden Musters
@@ -412,7 +412,7 @@
 <![CDATA[
 <?php
 // Gibt etwas ähnliches aus wie 'Wednesday the 15th'
-echo date("l \\t\h\e jS");
+echo date('l \t\h\e jS');
 ?>
 ]]>
     </programlisting>

Modified: phpdoc/de/trunk/reference/datetime/functions/getdate.xml
===================================================================
--- phpdoc/de/trunk/reference/datetime/functions/getdate.xml	2011-07-01 11:15:24 UTC (rev 312762)
+++ phpdoc/de/trunk/reference/datetime/functions/getdate.xml	2011-07-01 11:46:56 UTC (rev 312763)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 311354 Maintainer: sammywg Status: ready -->

 <refentry xml:id="function.getdate" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -163,6 +163,7 @@
    <simplelist>
     <member><function>date</function></member>
     <member><function>idate</function></member>
+    <member><function>localtime</function></member>
     <member><function>time</function></member>
     <member><function>setlocale</function></member>
    </simplelist>

Modified: phpdoc/de/trunk/reference/datetime/functions/gettimeofday.xml
===================================================================
--- phpdoc/de/trunk/reference/datetime/functions/gettimeofday.xml	2011-07-01 11:15:24 UTC (rev 312762)
+++ phpdoc/de/trunk/reference/datetime/functions/gettimeofday.xml	2011-07-01 11:46:56 UTC (rev 312763)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 311166 Maintainer: sammywg Status: ready -->

 <refentry xml:id="function.gettimeofday" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -12,7 +12,7 @@
   &reftitle.description;
   <methodsynopsis>
    <type>mixed</type><methodname>gettimeofday</methodname>
-   <methodparam choice="opt"><type>bool</type><parameter>return_float</parameter></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>return_float</parameter><initializer>false</initializer></methodparam>
   </methodsynopsis>
   <para>
    Es handelt sich um eine Schnittstelle zum Systemaufruf von gettimeofday(2).

Modified: phpdoc/de/trunk/reference/datetime/functions/gmdate.xml
===================================================================
--- phpdoc/de/trunk/reference/datetime/functions/gmdate.xml	2011-07-01 11:15:24 UTC (rev 312762)
+++ phpdoc/de/trunk/reference/datetime/functions/gmdate.xml	2011-07-01 11:46:56 UTC (rev 312763)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 311169 Maintainer: sammywg Status: ready -->

 <refentry xml:id="function.gmdate" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -13,7 +13,7 @@
   <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>
+   <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter><initializer>time()</initializer></methodparam>
   </methodsynopsis>
   <para>
    Identisch zur Funktion <function>date</function>, ausgenommen dass die

Modified: phpdoc/de/trunk/reference/datetime/functions/localtime.xml
===================================================================
--- phpdoc/de/trunk/reference/datetime/functions/localtime.xml	2011-07-01 11:15:24 UTC (rev 312762)
+++ phpdoc/de/trunk/reference/datetime/functions/localtime.xml	2011-07-01 11:46:56 UTC (rev 312763)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 311354 Maintainer: sammywg Status: ready -->

 <refentry xml:id="function.localtime" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -43,31 +43,27 @@
        <itemizedlist>
         <listitem>
          <simpara>
-          "tm_sec" - Sekunden
+          "tm_sec" - Sekunden, <literal>0</literal> bis <literal>59</literal>
          </simpara>
         </listitem>
         <listitem>
          <simpara>
-          "tm_min" - Minuten
+          "tm_min" - Minuten, <literal>0</literal> bis <literal>59</literal>
          </simpara>
         </listitem>
         <listitem>
          <simpara>
-          "tm_hour" - Stunde
+          "tm_hour" - Stunde, <literal>0</literal> bis <literal>23</literal>
          </simpara>
         </listitem>
         <listitem>
          <simpara>
-          "tm_mday" - Tag des Monats
+          "tm_mday" - Tag des Monats, <literal>1</literal> bis <literal>31</literal>
          </simpara>
-         <simpara>
-          Monate gehen von 0 (Jan) bis 11 (Dez)
-          und Wochentage von 0 (So) bis 6 (Sa).
-         </simpara>
         </listitem>
         <listitem>
          <simpara>
-          "tm_mon" - Monat des Jahres, beginnt bei 0 für Januar
+          "tm_mon" - Monat des Jahres, <literal>0</literal> (Jan) bis <literal>11</literal> (Dez)
          </simpara>
         </listitem>
         <listitem>
@@ -77,18 +73,21 @@
         </listitem>
         <listitem>
          <simpara>
-          "tm_wday" - Tag der Woche
+          "tm_wday" - Tag der Woche, <literal>0</literal> (Son) bis <literal>6</literal> (Sam)
          </simpara>
         </listitem>
         <listitem>
          <simpara>
-          "tm_yday" - Tag des Jahres
+          "tm_yday" - Tag des Jahres, <literal>0</literal> bis <literal>365</literal>
          </simpara>
         </listitem>
         <listitem>
          <simpara>
-          "tm_isdst" - für das Datum ist die Sommerzeit zu berücksichtigen
+          "tm_isdst" - Ob für das Datum die Sommerzeit zu berücksichtigen ist
          </simpara>
+         <simpara>
+          Positiv wenn Ja, <literal>0</literal> wenn Nein, negativ wenn unbekannt.
+         </simpara>
         </listitem>
        </itemizedlist>
       </para>
@@ -174,6 +173,16 @@
    </example>
   </para>
  </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>getdate</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+
 </refentry>

 <!-- Keep this comment at the end of the file

Modified: phpdoc/de/trunk/reference/datetime/functions/microtime.xml
===================================================================
--- phpdoc/de/trunk/reference/datetime/functions/microtime.xml	2011-07-01 11:15:24 UTC (rev 312762)
+++ phpdoc/de/trunk/reference/datetime/functions/microtime.xml	2011-07-01 11:46:56 UTC (rev 312763)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 311166 Maintainer: sammywg Status: ready -->

 <refentry xml:id="function.microtime" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -12,7 +12,7 @@
   &reftitle.description;
   <methodsynopsis>
    <type>mixed</type><methodname>microtime</methodname>
-   <methodparam choice="opt"><type>bool</type><parameter>get_as_float</parameter></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>get_as_float</parameter><initializer>false</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>microtime</function> gibt den aktuellen Unix-Timestamp mit
@@ -29,23 +29,34 @@
      <term><parameter>get_as_float</parameter></term>
      <listitem>
       <para>
-       Wird diese Funktion ohne den optionalen Parameter aufgerufen, gibt sie
-       die Zeichenkette "msec sec" zurück. Dabei entspricht sec der aktuellen
-       Zeit, ausgedrückt als Anzahl der Sekunden seit Beginn der UNIX-Epoche
-       (0:00:00 January 1, 1970 GMT), msec stellt den Mikrosekunden-Teil dar.
-       Beide Teile des Strings werden in Sekundeneinheiten zurückgegeben.
+       Wenn auf &true; gesetzt, gibt <function>microtime</function> einen
+       <type>float</type> anstatt einem <type>string</type> zurück, wie in
+       der Rückgabewert-Sektion unten genauer erläutert wird.
       </para>
-      <para>
-       Wenn der optionale Parameter <parameter>get_as_float</parameter> auf
-       &true; gesetzt wurde, wird eine Fließkommazahl (<type>float</type>)
-       mit Wertangabe in Sekunden zurückgegeben.
-      </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect1>

+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Standardmäßig gibt <function>microtime</function> einen <type>string</type>
+   im Format "Mikrosekunden Sekunden" zurück, wobei <literal>Sekunden</literal>
+   die aktuelle Zeit gemessen in Sekunden seit Beginn der Unix Epoche
+   (01. Januar 1970 00:00:00 GMT) ist und <literal>Mikrosekunden</literal> die
+   Anzahl an Mikrosekunden ist, die seit <literal>Sekunden</literal> vergangen
+   sind.
+  </para>
+  <para>
+   Wenn <parameter>get_as_float</parameter> &true; ist, gibt
+   <function>microtime</function> stattdessen einen <type>float</type>
+   zurück, welcher die aktuelle Zeit in Sekunden seit Beginn der Unix
+   Epoche angibt (die Nachkommastellen geben die Mikrosekunden an).
+  </para>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <para>

Modified: phpdoc/de/trunk/reference/datetime/functions/strtotime.xml
===================================================================
--- phpdoc/de/trunk/reference/datetime/functions/strtotime.xml	2011-07-01 11:15:24 UTC (rev 312762)
+++ phpdoc/de/trunk/reference/datetime/functions/strtotime.xml	2011-07-01 11:46:56 UTC (rev 312763)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 299419 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 309064 Maintainer: sammywg Status: ready -->

 <refentry xml:id="function.strtotime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,12 +17,12 @@
    <methodparam choice="opt"><type>int</type><parameter>now</parameter></methodparam>
   </methodsynopsis>
   <simpara>
-   Diese Funktion erwartet einen String mit einem Datum in US-englischem
+   Diese Funktion erwartet einen String mit einem Datum im Englischen
    Datumsformat und versucht, dieses Format in einen Unix-Timestamp (die Anzahl
    der Sekunden seit dem 01. Januar 1970 00:00:00 UTC) 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.
+   übergeben wurde, ausgewertet.
   </simpara>
   <para>
    Die Funktion verwendet, sofern diese verfügbar ist, die
@@ -203,12 +203,29 @@
     auf.
    </para>
   </note>
+  <note>
+   <para>
+    Daten im Format <literal>m/d/y</literal> oder <literal>d-m-y</literal>
+    werden unterschieden anhand des genutzten Trennzeichens: Wenn ein Slash
+    (<literal>/</literal>) genutzt wird, wird das Amerikanische Format
+    <literal>m/d/y</literal> angenommen; wird stattdessen ein Minus
+    (<literal>-</literal>) oder ein Punkt (<literal>.</literal>) genutzt,
+    wird das Europäische Format <literal>d-m-y</literal> angenommen.
+   </para>
+   <para>
+    Um Mehrdeutigkeiten zu vermeiden sollten am besten ISO 8601 Daten
+    (<literal>YYYY-MM-DD</literal>) genutzt werden oder aber die Methode
+    <methodname>DateTime::createFromFormat</methodname> verwendet werden.
+   </para>
+  </note>
  </refsect1>

  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
+    <member><methodname>DateTime::createFromFormat</methodname></member>
+    <member><function>checkdate</function></member>
     <member><function>strptime</function></member>
    </simplelist>
   </para>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.