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>