<?xml version="1.0" encoding="iso-8859-1"?>
 <reference id="ref.datetime">
  <title>Datums- und Zeit-Funktionen</title>
  <titleabbrev>Datum/Zeit</titleabbrev>
<!-- Anmerkung des bersetzers:
     entspricht en/functions/datetime.xml 1.23 -->

  <refentry id="function.checkdate">
   <refnamediv>
    <refname>checkdate</refname>
    <refpurpose>
     Prft eine gregorianische Datums- bzw. Zeitangabe auf Gltigkeit
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</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>
     Gibt &true; / wahr zurck, wenn das angegebene Datum gltig ist,
     sonst wird &false; / falsch zurck gegeben. Prft die Gltigkeit der
     angebenen Datumswerte. Ein Datum wird als gltig angesehen, wenn
     <itemizedlist>
      <listitem>
       <simpara>
        das Jahr zwischen 1 und 32767 (inclusive) ist,
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        der Monat zwischen 1 und 12 (inclusive) ist und
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        der Tag innerhalb der erlaubten Werte des angegebenen Monats
        ist. Schaltjahre werden bercksichtigt.
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
   </refsect1>
  </refentry>

  <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
     zurck. Dabei wird entweder der angegebene
     <parameter>timestamp</parameter> oder die gegenwrtige lokale
     Zeit bercksichtigt, wenn kein timestamp gegeben ist.
    </para>
    <para>
     Die folgenden Platzhalter werden zur Formatierung benutzt:
     <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 fhrender &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 fhrende &null;: "1" bis
	"12"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	G - Stunde im 24-Stunden-Format ohne fhrende &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 (groes 'i') - "1" bei Sommerzeit, sonst "0"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	j - Tag des Monats ohne fhrende &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 fr Schaltjahre: "0" oder "1"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	m - Monat: "01" to "12"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	n - Monat ohne fhrende &null;: "1" bis "12"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	M - Monat als 3 Buchstaben, z.B. "Jan"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	O - Zeitdifferenz zur Greenwich Zeit in Stunden (z.B. +0200)
       </simpara>
      </listitem>     
      <listitem>
       <simpara>
	r - Nach RFC 822 formattiertes 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 Aufzhlung, 2 Buchstaben, z.B. "th"
	[bei 4 fr fourth], "nd" [bei 2 fr second]
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	t - Anzahl der Tage des angegebenen Monats: "28" bis "31"
       </simpara>
      </listitem>
	  <listitem>
       <simpara>
    T - Zeitzoneneinstellung des Rechners, z.B. "MDT"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	U - Sekunden seit Beginn der UNIX-Epoche (1.1.1970)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	w - Wochentag 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 vierstellige Zahl, z.B. "1999"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	y - Jahr als zweistellige Zahl, z.B. "99"
       </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
	Minuten
       </simpara>
      </listitem>
     </itemizedlist>
     Nicht definierte Zeichen werden unverndert zurck gegeben.  Das
     "Z"-Format gibt "0" zurck beim Gebrauch von
     <function>gmdate</function>.
     <example>
      <title><function>date</function> Beispiel</title>
      <programlisting role="php">
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>
     Es ist mglich, <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>
       Beispiel
      </title>
      <programlisting role="php">
$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>
    </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>gmdate</function> und
     <function>mktime</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.getdate">
   <refnamediv>
    <refname>getdate</refname>
    <refpurpose>Gibt Datums- und Zeitinformationen zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>array</type><methodname>getdate</methodname>
      <methodparam><type>int</type><parameter>timestamp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt ein assoziatives Array mit Datums- und Zeitangaben des
     angegebenen Timestamp zurck.  Die Arrayelemente sind folgende:
     <itemizedlist>
      <listitem>
       <simpara>
	"seconds" - Sekunden
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"minutes" - Minuten
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"hours" - Stunden
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"mday" - Tag des Monats
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"wday" - numerischer Tag der Woche
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"mon" - Monat als Zahl
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"year" - Jahr als Zahl
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"yday" - Tag des Jahres als Zahlwert, z.B. "299"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"weekday" - ausgeschriebener Wochentag, z.B. "Friday"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"month" - ausgeschriebener Monatsname, z.B. "January"
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.gettimeofday">
   <refnamediv>
    <refname>gettimeofday</refname>
    <refpurpose>Gibt die aktuelle Zeit zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>array</type><methodname>gettimeofday</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Es handelt sich um eine Schnittstelle zum Systemaufruf von
     gettimeofday(2).  Die Zeitangaben werden als assoziatives Array
     zurck gegeben. Folgende Arrayelemente sind vorhanden:
     <itemizedlist>
      <listitem>
       <simpara>
	"sec" - Sekunden
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"usec" - Microsekunden
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"minuteswest" - Minuten westlich von Greenwich
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"dsttime" - Art der Korrektur der Sommerzeit
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.gmdate">
   <refnamediv>
    <refname>gmdate</refname>
    <refpurpose>Formatiert eine GMT Zeitangabe</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>gmdate</methodname>
      <methodparam><type>string</type><parameter>format</parameter></methodparam>
      <methodparam><type>int</type><parameter>timestamp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Entspricht der <function>date</function> Funktion, ausser das als
     Zeitangabe immer Greenwich Mean Time (GMT) zurck 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" zurck gibt.
     <example>
      <title><function>gmdate</function> Beispiel</title>
      <programlisting role="php">
echo date ("M d Y H:i:s", mktime (0,0,0,1,1,1998))."\n";
echo gmdate("M d Y H:i:s", mktime (0,0,0,1,1,1998))."\n";
      </programlisting>
     </example>
    </para>
    <para>
     Siehe auch <function>date</function>, <function>mktime</function>
     und <function>gmmktime</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.gmmktime">
   <refnamediv>
    <refname>gmmktime</refname>
    <refpurpose>
     Gibt den UNIX timestamp (Zeitstempel) als GMT zurck
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>gmmktime</methodname>
      <methodparam><type>int</type><parameter>Stunde</parameter></methodparam>
      <methodparam><type>int</type><parameter>Minute</parameter></methodparam>
      <methodparam><type>int</type><parameter>Secunde</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>
     Identisch zu <function>mktime</function>. Die angegebenen
     Parameter werden aber als GMT-Datum/Zeit zurck gegeben.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.gmstrftime">
   <refnamediv>
    <refname>gmstrftime</refname>
    <refpurpose>
     Wandelt eine lokale Zeitangabe in GMT-Format um
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>gmstrftime</methodname>
      <methodparam><type>string</type><parameter>format</parameter></methodparam>
      <methodparam><type>int</type><parameter>timestamp</parameter></methodparam>
     </methodsynopsis>
    <note>
     <para>
      Erst ab Version 3.0.12
     </para>
    </note>
    <para>
     Bewirkt das gleiche wie <function>strftime</function> mit dem
     Unterschied, dass die GMT-Zeit zurck gegeben wird. In
     Deutschland (GMT + 01:00) wird im folgenden Beispiel bei strftime
     "Dec 31 1998 00:00:00", bei gmstrftime dagegen "Dec 31 1998
     23:00:00" ausgegeben.
     <example>
      <title><function>gmstrftime</function> Beispiel</title>
      <programlisting role="php">
setlocale ('LC_TIME', 'ge');
echo strftime ("%b %d %Y %H:%M:%S", mktime(0,0,0,12,31,98))."\n";
echo gmstrftime ("%b %d %Y %H:%M:%S", mktime(0,0,0,12,31,98))."\n";
      </programlisting>
     </example>
    </para>
    <para>
     Siehe auch <function>strftime</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.localtime">
   <refnamediv>
    <refname>localtime</refname>
    <refpurpose>Ermittelt die lokalen Zeitwerte</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>array</type><methodname>localtime</methodname>
      <methodparam choice="opt"><type>int</type><parameter>
        timestamp
       </parameter></methodparam>
      <methodparam choice="opt"><type>bool</type><parameter>
        is_associative
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     Die <function>localtime</function>-Funktion gibt ein Array
     zurck, welches hinsichtlich seiner Struktur identisch ist mit
     dem des Funktionsaufrufs in C. Das erste (optionale) Argument
     von <function>localtime</function> ist der UNIX-Zeitstempel
     (Timestamp). Fehlt dieser, wird die aktuelle Zeit genommen. Als
     zweites wird der Parameter <parameter>is_associative</parameter>
     bergeben. Ist dieser 0 oder nicht gesetzt, wird das Werte-Array
     als regulres, numerisch indiziertes Array zurck gegeben. Ist
     er dagegen 1, liefert <function>localtime</function> ein
     assoziatives Array zurck, welches alle Elemente der Struktur des
     localtime-Aufrufs in C enthlt. Die Bezeichner der verschiedenen
     Schlssel dieses assoziatien Arrays lauten:
     <itemizedlist>
      <listitem>
       <simpara>
	"tm_sec" - Sekunde
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"tm_min" - Minute
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"tm_hour" - Stunde
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"tm_mday" - Tag des Monats
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"tm_mon" - Monat des Jahres
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"tm_year" - Jahr (nicht Y2K sicher)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"tm_wday" - Tag der Woche
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"tm_yday" - Tag des Jahres
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"tm_isdst" - fr das Datum ist die Sommerzeit zu bercksichtigen
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.microtime">
   <refnamediv>
    <refname>microtime</refname>
    <refpurpose>
     Gibt den aktuellen UNIX Timestamp/Zeitstempel in Mikrosekunden
     zurck
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>microtime</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Gibt die Zeichenkette "msec sec" zurck, wobei sec die aktuelle
     Zeit ist, ausgedrckt als Anzahl der Sekunden seit Beginn der
     UNIX-Epoche (0:00:00 January 1, 1970 GMT). Msec stellt den
     Mikrosekunden-Teil dar. Diese Funktion ist nur auf Systemen
     mglich, die den Systemaufruf gettimeofday() untersttzen.
    </para>
    <para>
     Siehe auch <function>time</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.mktime">
   <refnamediv>
    <refname>mktime</refname>
    <refpurpose>
     Gibt den UNIX Timestamp/Zeitstempel fr ein Datum zurck
    </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 hufige
     Fehlerursache in Scripts.
    </para>
    <para>
     Gibt den UNIX Timestamp/Zeitstempel an Hand der gegebenen
     Argumente zurck.  Der Zeitstempel ist ein long-integer-Wert, der
     die Anzahl der Sekunden zwischen der UNIX Epoche (01.01.1970) und
     der angegebenen Zeit enthlt.
    </para>
    <para>
     Einzelne Argumente knnen 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)
     heisst, dass nicht bekannt ist, ob Sommer- oder Winterzeit
     herrscht.
    </para>
    <note>
     <para>
      <parameter>is_dst</parameter> wurde in 3.0.10. eingefhrt.
     </para>
    </note>
    <para>
     <function>mktime</function> ist hilfreich bei Datumsberechnungen
     und -berprfungen, z.B. wird versucht, automatisch das korrekte
     Datum zu berechnen. So wird in den folgenden Beispielen immer die
     Zeichenkette "Jan-01-1998" ausgegeben.
     <example>
      <title><function>mktime</function> Beispiel</title>
      <programlisting>
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>
     <parameter>year</parameter> darf auch zweistellig angegeben
     werden.  Werte von 0 bis 69 stehen dann fr die Jahre 2000 bis
     2069, und 70 bis 99 fr die Jahre von 1970-1999 (auf Systemen,
     die time_t als 32Bit-Integer abbilden, liegt der gltige Bereich
     fr <parameter>year</parameter> zwischen 1902 und 2037).
    </para>
    <para>
     Der letzte Tag eines gegebenen Monats kann als der Tag "0" des
     nchsten Monats ausgedrckt werden (nicht als der Tag
     "-1"). Jedes der folgenden Beispiele gibt die Zeichenkette
     "Letzter Tag im Feb. 2000 ist der 29." zurck.
     <example>
      <title>Letzter Tag des nchsten 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 ungltig 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>

  <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 zurck, der den angegebenen
     Formatierungs-Merkmalen entspricht.  Dabei wird der gegebene
     Timestamp/Zeitstempel oder - falls dieser fehlt - die momentane
     lokale Zeit benutzt. Monats- und Wochentagsname wird entsprechend
     des per <function>setlocale</function> eingestellten Wertes
     gesetzt.
    </para>
    <para>
     Nachfolgend die im Formatierungsstring gltigen / bekannten
     Platzhalter:
     <itemizedlist>
      <listitem>
       <simpara>
	%a - abgekrzter Name des Wochentages, abhngig von der
	gesetzten Umgebung
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%A - ausgeschriebener Name des Wochentages, abhngig von der
	gesetzten Umgebung
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%b - abgekrzter Name des Monats, abhngig von der gesetzten
	Umgebung
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%B - ausgeschriebener Name des Monats, abhngig von der
	gesetzten Umgebung
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%c - Wiedergabewerte fr Datum und Zeit, abhngig von der
	gesetzten Umgebung
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%C - Jahrhundert (Jahr geteilt durch 100, gekrzt 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>
	%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' (abhngig von der gesetzten
	Umgebung) oder die entsprechenden Zeichenketten der gesetzten
	Umgebung
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%r - Zeit in "am"- oder "pm"-Formatierung
       </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>
      </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)
       </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), abhngig von der
	gesetzten Umgebung
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%X - bevorzugte Zeitwiedergabe (ohne Datum), abhngig 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
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%Z - Zeitzone
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%% - ein %-Zeichen
       </simpara>
      </listitem>
     </itemizedlist>
     <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_CA");
print (strftime ("%A und in Deutschland "));
setlocale ("LC_TIME", "de_DE");
print (strftime ("%A.\n"));
      </programlisting>
     </example>
      Diese Beispiel funktioniert, wenn sie die jeweilige Umgebung in
      ihrem System eingestellt haben.
     </para>
    <para>
     Siehe auch <function>setlocale</function> und
     <function>mktime</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.time">
   <refnamediv>
    <refname>time</refname>
    <refpurpose>
     Gibt den gegenwrtigen UNIX-Timestamp/Zeitstempel zurck
    </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 zurck.
    </para>
    <para>
     Siehe auch <function>date</function>.
    </para>
   </refsect1>
  </refentry>

  <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>
    <para>
     Diese Funktion erwartet einen String mit einem Datum im
     englischen Format und versucht, dieses in einen UNIX-Timestamp
     umzusetzen.
     <example>
      <title><function>strtotime</function>-Beispiele:</title>
      <programlisting role="php">
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";
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

 </reference>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->