sammywg		Tue Aug 26 22:37:46 2008 UTC

  Modified files:              
    /phpdoc-de/reference/datetime/functions	gmdate.xml gmmktime.xml 
                                           	gmstrftime.xml 
  Log:
  sync to en
  set encoding to utf-8
  
  
  
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/datetime/functions/gmdate.xml?r1=1.11&r2=1.12&diff_format=u
Index: phpdoc-de/reference/datetime/functions/gmdate.xml
diff -u phpdoc-de/reference/datetime/functions/gmdate.xml:1.11 phpdoc-de/reference/datetime/functions/gmdate.xml:1.12
--- phpdoc-de/reference/datetime/functions/gmdate.xml:1.11	Wed Jun 18 00:08:57 2008
+++ phpdoc-de/reference/datetime/functions/gmdate.xml	Tue Aug 26 22:37:46 2008
@@ -1,67 +1,127 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.11 $ -->
-<!-- EN-Revision: 1.8 Maintainer: nobody Status: ready -->
-
-  <refentry xml:id="function.gmdate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
-   <refnamediv>
-    <refname>gmdate</refname>
-    <refpurpose>Formatiert eine GMT/UTC 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>
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 1.12 $ -->
+<!-- EN-Revision: 1.13 Maintainer: sammywg Status: ready -->
+
+<refentry xml:id="function.gmdate" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>gmdate</refname>
+  <refpurpose>Formatiert eine GMT/UTC Zeit-/Datumsangabe</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <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>
+   Identisch zur Funktion <function>date</function>, ausgenommen dass die
+   zurückgegebene Zeitangabe Greenwich Mean Time (GMT) entspricht.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>format</parameter></term>
+     <listitem>
+      <para>
+       Das Format des ausgegebenen Datums<type>string</type>s. Siehe auch die
+       Formatierungsoptionen der <function>date</function>-Funktion.
+      </para>
+     </listitem>
+    </varlistentry>
+
+    &date.timestamp.description;
+
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Gibt einen formatierten Datumsstring zurück. Wenn ein nichtnumerischer Wert
+   für <parameter>timestamp</parameter> verwendet wird, wird &false; zurückgegeben
+   und eine Fehlermeldung vom Typ <literal>E_WARNING</literal> erzeugt.
+  </para>
+ </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>
+        Der valide Bereich eines Timestamps ist typischerweise von Freitag, den
+        13. Dezember 1901 20:45:54 GMT bis Dienstag, den 19. Januar 2038
+        03:14:07 GMT. (Dies sind die Daten, die zum kleinsten und größten
+        mögichen Wert für einen vorzeichenbehafteten 32-Bit Integer
+        korrespondieren.) Vor PHP 5.1.0 war dieser Bereich auf einigen Systemen
+        (z.B. Windows) limitiert auf den Zeitraum 01-01-1970 bis 19-01-2038.
+       </entry>
+      </row>
+      <row>
+       <entry>5.1.1</entry>
+       <entry>
+        Es gibt nützliche <link linkend="datetime.constants">Konstanten</link>
+        für Standard-Datums-/-Zeitformate, die verwendet werden können, um
+        den <parameter>format</parameter>-Parameter zu spezifizieren.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>gmdate</function>-Beispiel</title>
     <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">
+     Wenn das Skript in Finnland (GMT +0200) ausgeführt wird, gibt die erste
+     Zeile "Jan 01 1998 00:00:00" aus, während die zweite Zeile
+     "Dec 31 1997 22:00:00" zurückgibt.
+    </para>
+    <programlisting role="php">
 <![CDATA[
 <?php
 echo date("M d Y H:i:s", mktime(0, 0, 0, 1, 1, 1998));
 echo gmdate("M d Y H:i:s", mktime(0, 0, 0, 1, 1, 1998));
 ?>
 ]]>
-      </programlisting>
-     </example>
-    </para>
-    <note>
-     <para>
-      Bei den Microsoft Betriebssystemen ist die Systembibliothek, die diese
-      Funktionalität zur Verfügung stellt, defekt. Das hat zur Folge, dass
-      <function>gmdate</function> keine negativen Werte für den Parameter
-      <parameter>Timestamp</parameter> unterstützt. Weitere Details können Sie
-      folgenden Bugreports entnehmen:
-      <link xlink:href="&url.php.bugs;22620">#22620</link>,
-      <link xlink:href="&url.php.bugs;22457">#22457</link>
-      und <link xlink:href="&url.php.bugs;14391">#14391</link>.
-     </para>
-     <para>
-      Bei Unix/Linux Systemen ist dieses Problem nicht vorhanden. Hier funktionieren
-      die Systembibliotheken wie erwartet.
-     </para>
-     <para>
-      PHP kann keine defekten Systembibliotheken reparieren. Kontaktieren Sie den
-      Hersteller Ihres Betriebssystems und bitten Sie um Reparatur für dieses und
-      ähnliche Probleme.
-     </para>
-    </note>
-    <para>
-     Siehe auch
-     <function>date</function>,
-     <function>mktime</function>,
-     <function>gmmktime</function> und
-     <function>strftime</function>.
-    </para>
-   </refsect1>
-  </refentry>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>date</function></member>
+    <member><function>mktime</function></member>
+    <member><function>gmmktime</function></member>
+    <member><function>strftime</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/gmmktime.xml?r1=1.9&r2=1.10&diff_format=u
Index: phpdoc-de/reference/datetime/functions/gmmktime.xml
diff -u phpdoc-de/reference/datetime/functions/gmmktime.xml:1.9 phpdoc-de/reference/datetime/functions/gmmktime.xml:1.10
--- phpdoc-de/reference/datetime/functions/gmmktime.xml:1.9	Wed Jun 18 00:08:57 2008
+++ phpdoc-de/reference/datetime/functions/gmmktime.xml	Tue Aug 26 22:37:46 2008
@@ -1,59 +1,164 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
-<!-- EN-Revision: 1.6 Maintainer: nobody Status: ready -->
-
-  <refentry xml:id="function.gmmktime" xmlns="http://docbook.org/ns/docbook">
-   <refnamediv>
-    <refname>gmmktime</refname>
-    <refpurpose>
-     Gibt einen Unix-Timestamp (Zeitstempel) für ein GMT Datum zurück
-    </refpurpose>
-   </refnamediv>
-   <refsect1>
-    <title>Beschreibung:</title>
-     <methodsynopsis>
-      <type>int</type><methodname>gmmktime</methodname>
-      <methodparam choice="opt"><type>int</type><parameter>Stunde</parameter></methodparam>
-      <methodparam choice="opt"><type>int</type><parameter>Minute</parameter></methodparam>
-      <methodparam choice="opt"><type>int</type><parameter>Sekunde</parameter></methodparam>
-      <methodparam choice="opt"><type>int</type><parameter>Monat</parameter></methodparam>
-      <methodparam choice="opt"><type>int</type><parameter>Tag</parameter></methodparam>
-      <methodparam choice="opt"><type>int</type><parameter>Jahr</parameter></methodparam>
-      <methodparam choice="opt"><type>int</type><parameter>is_dst</parameter></methodparam>
-     </methodsynopsis>
-    <para>
-     Identisch zu <function>mktime</function>. Die angegebenen
-     Parameter werden aber als GMT-Datum/Zeit interpretiert.
-    </para>
-    <para>
-     Die Parameter repräsentieren immer ein GMT Datum, daher hat
-     <parameter>is_dst</parameter> keinen Einfluss auf das Egebnis.
-    </para>
-    <para>
-     Wie bei <function>mktime</function> können Argumente von rechts nach links
-     weggelassen werden, wobei jedes fehlende Argument auf den gegenwärtigen
-     entsprechenden GMT Wert gesetzt wird.
-    </para>
-    <para>
-     <note>
-      <simpara>
-       <function>gmmktime</function> verwendet intern <function>mktime</function>,
-       so dass nur Zeiten gültig sind, die von der lokalen Zeit abgeleitet wurden.
-      </simpara>
-     </note>
-     <example>
-      <title><function>gmmktime</function> Beispiel</title>
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 1.10 $ -->
+<!-- EN-Revision: 1.11 Maintainer: sammywg Status: ready -->
+
+<refentry xml:id="function.gmmktime" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>gmmktime</refname>
+  <refpurpose>Gibt einen Unix-Timestamp (Zeitstempel) für ein GMT Datum zurück</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>int</type><methodname>gmmktime</methodname>
+   <methodparam choice="opt"><type>int</type><parameter>hour</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>minute</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>second</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>month</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>day</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>is_dst</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Identisch zu <function>mktime</function> mit der Ausnahme, dass die übergebenen
+   Parameter ein GMT-Datum repräsentieren. <function>gmmktime</function> greift
+   intern auf <function>mktime</function> zurück, so dass nur Zeitangaben valide
+   sind, die in der ausgewählten lokalen Zeitzone genutzt werden können.
+  </para>
+  <para>
+   Wie bei <function>mktime</function> können Argumente von rechts nach links
+   weggelassen werden, wobei jedes fehlende Argument auf den gegenwärtigen
+   entsprechenden GMT-Wert gesetzt wird.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>hour</parameter></term>
+     <listitem>
+      <para>
+       Die Stunde
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>minute</parameter></term>
+     <listitem>
+      <para>
+       Die Minute
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>second</parameter></term>
+     <listitem>
+      <para>
+       Die Sekunde
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>month</parameter></term>
+     <listitem>
+      <para>
+       Der Monat
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>day</parameter></term>
+     <listitem>
+      <para>
+       Der Tag
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>year</parameter></term>
+     <listitem>
+      <para>
+       Das Jahr
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>is_dst</parameter></term>
+     <listitem>
+      <para>
+       Parameter repräsentieren immer ein GMT-Datum, so dass
+       <parameter>is_dst</parameter> keinen Einfluss auf das Ergebnis nimmt.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Gibt einen Unix Timestamp im <type>integer</type>-Format zurück.
+  </para>
+ </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>
+        Mit der Einführung von PHP 5.1.0 wird der Parameter
+        <parameter>is_dst</parameter> als veraltet betrachtet. In der Folge
+        sollten stattdessen die neuen Zeitzonenhandling-Features verwendet
+        werden.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>gmmktime</function> unter den Beschränkungen von Windows</title>
       <programlisting role="php">
 <![CDATA[
 <?php
-gmmktime(0, 0, 0, 1, 1, 1970); // gültig in GMT und west, ungültig in east
+gmmktime(0, 0, 0, 1, 1, 1970); // gültig in GMT und west, ungültig in east
 ?>
 ]]>
-      </programlisting>
-     </example>
-    </para>
-   </refsect1>
-  </refentry>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>mktime</function></member>
+    <member><function>date</function></member>
+    <member><function>time</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/gmstrftime.xml?r1=1.8&r2=1.9&diff_format=u
Index: phpdoc-de/reference/datetime/functions/gmstrftime.xml
diff -u phpdoc-de/reference/datetime/functions/gmstrftime.xml:1.8 phpdoc-de/reference/datetime/functions/gmstrftime.xml:1.9
--- phpdoc-de/reference/datetime/functions/gmstrftime.xml:1.8	Wed Jun 18 00:08:57 2008
+++ phpdoc-de/reference/datetime/functions/gmstrftime.xml	Tue Aug 26 22:37:46 2008
@@ -1,46 +1,87 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
-<!-- EN-Revision: 1.7 Maintainer: nobody Status: ready -->
-
-  <refentry xml:id="function.gmstrftime" xmlns="http://docbook.org/ns/docbook">
-   <refnamediv>
-    <refname>gmstrftime</refname>
-    <refpurpose>
-     Formatiert eine Datum-/Zeitangabe in GMT/UTC-Format entsprechend den
-     lokalen Einstellungen
-    </refpurpose>
-   </refnamediv>
-   <refsect1>
-    <title>Beschreibung:</title>
-     <methodsynopsis>
-      <type>string</type><methodname>gmstrftime</methodname>
-      <methodparam><type>string</type><parameter>Format</parameter></methodparam>
-      <methodparam choice="opt"><type>int</type><parameter>Timestamp</parameter></methodparam>
-     </methodsynopsis>
-    <para>
-     Bewirkt das gleiche wie <function>strftime</function> mit dem
-     Unterschied, dass die Zeit nach Greenwich Mean Time (GMT) zurückgegeben
-     wird. In Deutschland (GMT + 01:00) wird im folgenden Beispiel bei
-     der ersten Zeile "Dez 31 1998 00:00:00" ausgegeben, dagegen gibt die
-     zweite Zeile "Dec 31 1998 23:00:00" aus.
-     <example>
-      <title><function>gmstrftime</function> Beispiel</title>
-      <programlisting role="php">
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 1.9 $ -->
+<!-- EN-Revision: 1.11 Maintainer: sammywg Status: ready -->
+
+<refentry xml:id="function.gmstrftime" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>gmstrftime</refname>
+  <refpurpose>Formatiert eine Datum-/Zeitangabe in GMT/UTC-Format entsprechend den
+   lokalen Einstellungen</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>string</type><methodname>gmstrftime</methodname>
+   <methodparam><type>string</type><parameter>format</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Bewirkt das gleiche wie <function>strftime</function> mit dem
+   Unterschied, dass die Zeit nach Greenwich Mean Time (GMT) zurückgegeben
+   wird. Wenn das Skript beispielsweise unter Eastern Standard Time (GMT -0500)
+   läuft, gibt die erste Zeile unten "Dec 31 1998 20:00:00" aus, während die
+   zweite "Jan 01 1999 01:00:00" ausgibt.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>format</parameter></term>
+     <listitem>
+      <para>
+       Siehe die Beschreibung bei <function>strftime</function>.
+      </para>
+     </listitem>
+    </varlistentry>
+    &date.timestamp.description;
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Gibt eine entsprechend dem übergebenen Formatstring formatierte Zeichenkette
+   zurück. Die verwendete Zeitangabe wird durch den übergebenen
+   <parameter>timestamp</parameter> oder die aktuelle lokale Zeit festgelegt,
+   wenn kein Timestamp angegeben wurde. Monats- und Wochentagsnamen sowie
+   andere sprachabhängige Zeichenketten beziehen sich auf die via
+   <function>setlocale</function> festgelegte aktuelle Locale-Angabe.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>gmstrftime</function>-Beispiel</title>
+    <programlisting role="php">
 <![CDATA[
 <?php
-setlocale (LC_TIME, 'de_DE');
+setlocale(LC_TIME, 'en_US');
 echo strftime("%b %d %Y %H:%M:%S", mktime(20, 0, 0, 12, 31, 98)) . "\n";
 echo gmstrftime("%b %d %Y %H:%M:%S", mktime(20, 0, 0, 12, 31, 98)) . "\n";
 ?>
 ]]>
-      </programlisting>
-     </example>
-    </para>
-    <para>
-     Siehe auch <function>strftime</function>.
-    </para>
-   </refsect1>
-  </refentry>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>strftime</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
+
 
 <!-- Keep this comment at the end of the file
 Local variables: