<?xml version="1.0" encoding="iso-8859-1"?>
 <reference id="ref.calendar">
  <title>Kalender-Funktionen</title>
  <titleabbrev>Kalender</titleabbrev>

  <partintro>
   <para>
    Dieses Modul bietet eine Reihe von Funktionen, die die Umwandlung
    von Daten zwischen verschiedenen Kalendern erleichtern. Die
    gemeinsame Basis fr diese Umwandlung bildet das Julianische Datum
    J. D. (nicht zu verwechseln mit dem Julianischen Kalender). Das
    J. D. entspricht der Anzahl der Tage seit dem 1. 1. 4713 v. Chr. Jede
    Umrechnung zwischen zwei beliebigen Kalendern erfordert den
    Zwischenschritt ber das J. D.
   </para>
   <para>
    Weitere Informationen zum Thema liefert die Seite <ulink
    url="&url.calendar;">&url.calendar;</ulink>, aus der Teile der
    Erklrungen in den folgenden Funktionsbeschreibungen stammen,
    sowie die sehr ausfhrliche <ulink
    url="&url.calendar.time;">Homepage zum Thema ZEIT</ulink>.
   </para>
   <warning>
    <para>
     In PHP3 und lteren Versionen von PHP4 (bis einschlielich
     PHP4RC1) sind diese Funktionen nur verfgbar, wenn Sie die
     Kalender-Erweiterungen unter dl/calendar bersetzt haben. Weitere
     Informationen finden Sie in der Datei dl/README.
    </para>
   </warning>
  </partintro>

  <refentry id="function.jdtogregorian">
   <refnamediv>
    <refname>JDToGregorian</refname>
    <refpurpose>
     Konvertierung vom Julianischen Datum zum Gregorianischen Kalender
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>jdtogregorian</methodname>
      <methodparam><type>int</type><parameter>julianday</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion konvertiert den in
     <parameter>julianday</parameter> angegebenen Tag im Julianischen
     Datum in einen String, der das Datum nach dem Gregorianischen
     Kalender in der Form "MM/DD/YYYY" enthlt.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.gregoriantojd">
   <refnamediv>
    <refname>GregorianToJD</refname> 
    <refpurpose>
     Konvertierung vom Gregorianischen Kalender zum Julianischen Datum
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>gregoriantojd</methodname>
      <methodparam><type>int</type><parameter>month</parameter></methodparam>
      <methodparam><type>int</type><parameter>day</parameter></methodparam>
      <methodparam><type>int</type><parameter>year</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion konvertiert das in <parameter>month</parameter>,
     <parameter>day</parameter> und <parameter>year</parameter>
     bergebene Datum im Gregorianischen Kalender in einen Tag im
     Julianischen Datum.
    </para>
    <para>
     Gltige Daten liegen im Bereich von 4714 v. Chr. bis 9999 n. Chr.
     Der Gregorianische Kalender wurde allerdings erst am 15. Oktober
     1582 (bzw. am 5. Oktober nach dem bis dahin gltigen Julianischen
     Kalender) von Papst Gregor XIII. eingefhrt, in einigen
     Lndern erst sehr viel spter. So bernahmen die
     Briten den Gregorianischen Kalender 1752, die UDSSR 1918 und
     Griechenland erst im Jahre 1923. In den meisten europischen
     Lndern wurde vor dem Gregorianischen der Julianische Kalender
     benutzt.
     <example>
      <title>Calendar functions</title>
      <programlisting role="php">
&lt;?php
$jd = GregorianToJD (10,11,1970);
echo "$jd\n";
$gregorian = JDToGregorian ($jd);
echo "$gregorian\n";
?>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>
 
  <refentry id="function.jdtojulian">
   <refnamediv>
    <refname>JDToJulian</refname> 
    <refpurpose>
     Konvertierung vom Julianischen Datum zum Julianischen Kalender
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>jdtojulian</methodname>
      <methodparam><type>int</type><parameter>julianday</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion konvertiert den in
     <parameter>julianday</parameter> angegebenen Tag im Julianischen
     Datum in einen String, der das entsprechnde Datum im Julianischen
     Kalender in der Form "MM/DD/YYYY" enthlt.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.juliantojd">
   <refnamediv>
    <refname>JulianToJD</refname> 
    <refpurpose>
     Konvertierung vom Julianischen Kalender zum Julianischen Datum
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>juliantojd</methodname>
      <methodparam><type>int</type><parameter>month</parameter></methodparam>
      <methodparam><type>int</type><parameter>day</parameter></methodparam>
      <methodparam><type>int</type><parameter>year</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion konvertiert das in <parameter>month</parameter>,
     <parameter>day</parameter> und <parameter>year</parameter>
     bergebene Datum im Gregorianischen Kalender in einen Tag im
     Julianischen Datum.
    </para>
    <para>
     Gltige Daten liegen im Bereich von 4714 v.Chr. bis 9999 n.Chr.
     Der Julianische Kalender wurde allerdings erst 46 v.Chr.
     eingefhrt, und die Details der Anwendung stabilisierten sich
     frhestens im Jahre 8 n. Chr., z. T. vielleicht sogar erst im
     vierten Jahrhundert nach Christus.  Weiterhin betrachteten nicht
     alle Kulturen, die sich nach diesem Kalender richteten, den
     Januar als den ersten Monat des Jahres.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.jdtojewish">
   <refnamediv>
    <refname>JDToJewish</refname>
    <refpurpose>
     Konvertierung vom Julianischen Datum zum Jdischen Kalender
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>jdtojewish</methodname>
      <methodparam><type>int</type><parameter>julianday</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion konvertiert den in
     <parameter>julianday</parameter> angegebenen Tag im Julianischen
     Datum in einen String, der das entsprechnde Datum im Jdischen
     Kalender in der Form "MM/DD/YYYY" enthlt.
    </para>
   </refsect1>
  </refentry>
 
  <refentry id="function.jewishtojd">
   <refnamediv>
    <refname>JewishToJD</refname> 
    <refpurpose>
     Konvertiert vom Jdischen Kalender zum Julianischen Datum
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>jewishtojd</methodname>
      <methodparam><type>int</type><parameter>month</parameter></methodparam>
      <methodparam><type>int</type><parameter>day</parameter></methodparam>
      <methodparam><type>int</type><parameter>year</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion konvertiert das in <parameter>month</parameter>,
     <parameter>day</parameter> und <parameter>year</parameter>
     bergebene Datum im Jdischen Kalender in einen Tag im
     Julianischen Datum.
    </para>
    <para>
     Gltige Daten beginnen mit dem Jahr 1 (3761 v. Chr.). Der Jdische
     Kalender ist bereits seit mehreren Jahrtausenden im Gebrauch,
     wobei ein neuer Monat jeweils mit der ersten Beobachtung des
     Neumonds beginnt.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.jdtofrench">
   <refnamediv>
    <refname>JDToFrench</refname>
    <refpurpose>
     Konvertiert ein Julianisches Datum zum Kalender der Franzsischen
     Revolution
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>jdtofrench</methodname>
      <methodparam><type>int</type><parameter>month</parameter></methodparam>
      <methodparam><type>int</type><parameter>day</parameter></methodparam>
      <methodparam><type>int</type><parameter>year</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion konvertiert den in
     <parameter>julianday</parameter> angegebenen Tag im Julianischen
     Datum in einen String, der das entsprechnde Datum im Kalender der
     Franzsischen Revolution in der Form "MM/DD/YYYY" enthlt.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.frenchtojd">
   <refnamediv>
    <refname>FrenchToJD</refname>
    <refpurpose>
     Konvertiert ein Datum der Franzsischen Revolution zu einem
     Julianischen Datum
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>frenchtojd</methodname>
      <methodparam><type>int</type><parameter>month</parameter></methodparam>
      <methodparam><type>int</type><parameter>day</parameter></methodparam>
      <methodparam><type>int</type><parameter>year</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion konvertiert das in <parameter>month</parameter>,
     <parameter>day</parameter> und <parameter>year</parameter>
     bergebene Datum im Kalender der Franzsischen Revolution in
     einen Tag im Julianischen Datum.
    </para>
    <para>
     Diese Funktion verarbeitet nur Daten der Jahre 1 bis 14
     (22. September 1792 bis 22. September 1806 im Gregorianischen
     Kalender), dieser Zeitraum geht aber immer noch ber die
     Lebensdauer des Revolutionskalenders hinaus.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.jdmonthname">
   <refnamediv>
    <refname>JDMonthName</refname>
    <refpurpose>
     Bestimmt den Monat aus dem Julianischen Datum
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>jdmonthname</methodname>
      <methodparam><type>int</type><parameter>julianday</parameter></methodparam>
      <methodparam><type>int</type><parameter>mode</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion bestimmt den Monatsnamen fr den in
     <parameter>julianday</parameter> bergebenen Tag im Julianischen
     Datum.  Die Ausgabe erfolgt als String in Abhngigkeit von
     <parameter>mode</parameter>.
     <table>
      <title>Mgliche <parameter>mode</parameter> Werte</title>
      <tgroup cols="2">
       <thead>
	<row>
	 <entry>Mode</entry>
	 <entry>Bedeutung</entry>
	</row>
       </thead>
       <tbody>
	<row>
	 <entry>0</entry>
	 <entry>Gregorianisch (Abk.)</entry>
	</row>
	<row>
	 <entry>1</entry>
	 <entry>Gregorianisch</entry>
	</row>
	<row>
	 <entry>2</entry>
	 <entry>Julianisch - (Abk.)</entry>
	</row>
	<row>
	 <entry>3</entry>
	 <entry>Julianisch</entry>
	</row>
	<row>
	 <entry>4</entry>
	 <entry>Jdisch</entry>
	</row>
	<row>
	 <entry>5</entry>
	 <entry>Franzsisch revolutionr</entry>
	</row>
       </tbody>
      </tgroup>
     </table>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.jddayofweek"> 
   <refnamediv>
    <refname>JDDayOfWeek</refname>
    <refpurpose>
     Bestimmt den Wochentag aus einem Julianischen Datum
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>mixed</type><methodname>jddayofweek</methodname>
      <methodparam><type>int</type><parameter>julianday</parameter></methodparam>
      <methodparam><type>int</type><parameter>mode</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion bestimmt den Wochentag fr den in
     <parameter>julianday</parameter> bergebenen Tag im Julianischen
     Datum.  Die Ausgabe erfolgt in Abhngigkeit von
     <parameter>mode</parameter> als integer oder string.
     <table>
      <title>Mgliche <parameter>mode</parameter> Werte</title>
      <tgroup cols="2">
       <thead>
 	<row>
	 <entry>Mode</entry>
	 <entry>Bedeutung</entry>
 	</row>
       </thead>
       <tbody>
        <row>
	 <entry>0</entry> 
	 <entry>
	  Nummer des Tages als integer (0=Sontag, 1=Montag, ...)
	 </entry>
        </row>
        <row>
	 <entry>1</entry> 
	 <entry>Tagesname als String (Englisch-Gregorianisch)</entry>
        </row>
        <row>
	 <entry>2</entry> 
	 <entry>
	  abgekrzter Tagesname als String (Englisch-Gregorianisch)
	 </entry>
        </row>
       </tbody>
      </tgroup>
     </table>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.easter-date">
   <refnamediv>
    <refname>easter_date</refname>
    <refpurpose>
     Zeitpunkt des Osterfestes (0 Uhr) als UNIX-Timestamp
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>easter_date</methodname>
      <methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion liefert den UNIX-Timestamp (in Sekunden seit 1970)
     zurck, der dem Begin des Ostersonntag im durch
     <parameter>year</parameter> spezifizierten Jahr entspricht.  Wird
     kein Jahr angegeben, so wird der Zeitpunkt fr das laufende Jahr
     bestimmt.
    </para>
    <warning> 
     <para>
      Liegt das angegebene Jahr vor 1970 oder nach 2037 (auf
      32 bit-Systemen), so wird eine Warnung ausgegeben und das Ergebnis
      ist nicht gltig.
     </para>
    </warning>
    <para> 
     <example>
      <title><function>easter_date</function> Beispiel</title>
      <programlisting role="php">
echo date ("M-d-Y", easter_date(1999));        /* " 4. April 1999" */
echo date ("M-d-Y", easter_date(2000));        /* "23. April 2000" */
echo date ("M-d-Y", easter_date(2001));        /* "15. April 2001" */
      </programlisting>
     </example>
    </para>
    <para>
     Das Datum des Osterfestes wurde im Jahre 325 auf dem Konzil von
     Nicaea auf den ersten Sonntag nach Frhlingsvollmond, also dem
     Vollmond whrend oder direkt nach der Tagundnachtgleiche am
     21. Mrz, festgelegt.  Der hier genutzte Algorithmus wurde um das Jahr 532
     von Dionysius Exiguus eingefhrt. Bis zum Jahr 1752 wird nach dem
     Julianischen Kalender ein einfacher 19jhriger Zyklus fr die
     Bestimmung der Mondphasen benutzt. Im September 1752 bernahmen
     dann auch Britannien und seine Kolonien den von Clavius und
     Lilius vorgeschlagenen und im Oktober 1582 von Papst Gregor dem
     XIII.  eingefhrten Gregorianischen Kalender. Hierdurch wurden
     zwei Korrekturfaktoren eingefhrt, um den Zyklus genauer
     abzubilden.
    </para>
    <para>
     (Der Code basiert auf einen C-Programm von Simon Kershaw,
     &lt;webmaster@ely.anglican.org&gt;)
    </para>
    <para>
     Siehe auch <function>easter_days</function> fr die Bestimmung
     von Osterfesten vor 1970 oder nach 2037.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.easter-days">
   <refnamediv>
    <refname>easter_days</refname>
    <refpurpose>
     Anzahl der Tage zwischen dem 21. Mrz und Ostersonntag
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>easter_days</methodname>
      <methodparam><type>int</type><parameter>year</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion ermittelt den Abstand in Tagen zwischen der 
     Frhlings-Tagundnachtgleiche und dem Ostersonntag im durch
     <parameter>year</parameter> angegebenen Jahr. Wird kein Jahr
     angegeben, so wird der Wert fr das laufende Jahr bestimmt.
    </para>
    <para>
     Diese Funktion kann im Gegensatz zu
     <function>easter_date</function> das Osterfest auch in Jahren vor
     1970 und nach 2037 bestimmen.
     <example>
      <title><function>easter_date</function> Beispiel</title>
      <programlisting>
echo easter_days (1999);        /* 14, i.e. April 4   */
echo easter_days (1492);        /* 32, i.e. April 22  */
echo easter_days (1913);        /*  2, i.e. March 23  */
      </programlisting>
     </example>
    </para>
    <para>
     Siehe auch <function>easter_date</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.unixtojd">
   <refnamediv>
    <refname>unixtojd</refname>
    <refpurpose>
     Konvertiert UNIX-Timestamp in Julianisches Datum
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>unixtojd</methodname>
      <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion konvertiert den in
     <parameter>timestamp</parameter> bergebenen Wert (in Sekunden
     seit dem 1.1.1970) in das entsprechende Julianische Datum.  Wird
     kein <parameter>timestamp</parameter> bergeben, so wird das
     Julianische Datum des aktuellen Tages zurckgegeben.
    </para>
    <para>
     Siehe auch <function>jdtounix</function>.
    </para>
    <note>
     <para>
      Diese Funktion ist nur in PHP-Versionen nach PHP4RC1 verfgbar.
     </para>
    </note>
   </refsect1>
  </refentry>
  
  <refentry id="function.jdtounix"> 
   <refnamediv>
    <refname>jdtounix</refname>
    <refpurpose>
     Konvertiert Julianisches Datum in UNIX-Timestamp
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>jdtounix</methodname>
      <methodparam><type>int</type><parameter>jday</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion liefert einen UNIX Timestamp (in Sekunden seit dem
     1.1.1970) zurck, der dem in <parameter>jday</parameter>
     bergebenen Julianischen Datum entspricht.  Liegt
     <parameter>jday</parameter> auerhalb des darstellbaren
     Zeitbereichs (Gregorianische Jahre von 1970 bis 2037 bzw.
     2440588 &lt;= <parameter>jday</parameter> &lt;= 2465342 ), so
     wird &false; zurckgegeben.
    </para>
    <para>
     Siehe auch <function>unixtojd</function>.
    </para>
    <note>
     <para>
      Diese Funktion ist nur in PHP-Versionen nach PHP4RC1 verfgbar.
     </para>
    </note>
   </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:
-->