<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.23 Maintainer: cucinato Status: ready -->
 <reference id="ref.calendar">
  <title>Funzioni Calendar</title>
  <titleabbrev>Calendar</titleabbrev>
  <partintro>
   <section>
    <title>Introduzione</title>
    <para>
     L'estensione calendar presenta una serie di funzioni che semplificano 
     la conversione tra differenti formati di calendario.  Il formato intermedio
     o standard &egrave; basato sul Conteggio del Giorno Giuliano.  Il Conteggio
     Giuliano &egrave; un conteggio di giorni che parte molto prima di qualsiasi data
     la maggior parte della gente potrebbe usare (circa il 4000 a.C.).  Per
     convertire tra i sistemi di calendario, si deve prima convertire nel sistema
     del Giorno Giuliano, poi nel sistema di calendario scelto.  Il Conteggio del Giorno
     Giuliano &egrave; molto diverso dal Calendario Giulano! Per maggiori
     informazioni sui sistemi di calendario vedere <ulink
     url="&url.calendar;">&url.calendar;</ulink>.  Parti di questa
     pagina sono inclusi in queste istruzioni, citate tra virgolette.
    </para>
   </section>
   <section>
    <title>Installazione</title>
    <para>
     Per rendere disponibili queste funzioni, occorre compilare PHP con
     <option role="configure">--enable-calendar</option>.
    </para>
   </section>
  </partintro>

  <refentry id="function.jdtogregorian">
   <refnamediv>
    <refname>JDToGregorian</refname>
    <refpurpose>Converte il Giorno Giuliano in data Gregoriana</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>jdtogregorian</methodname>
      <methodparam><type>int</type><parameter>giornogiuliano</parameter></methodparam>
     </methodsynopsis>
    <para>
     Converte il Giorno Giuliano in una stringa contenente la data
     Gregoriana nel formato "mese/giorno/anno".
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.gregoriantojd">
   <refnamediv>
    <refname>GregorianToJD</refname> 
    <refpurpose>
     Converte una data Gregoriana in un Giorno Giuliano
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>int</type><methodname>gregoriantojd</methodname>
      <methodparam><type>int</type><parameter>mese</parameter></methodparam>
      <methodparam><type>int</type><parameter>giorno</parameter></methodparam>
      <methodparam><type>int</type><parameter>anno</parameter></methodparam>
     </methodsynopsis>
    <para>
     L'intervallo valido per il Calendario Gregoriano &egrave; dal 4714 a.C. al 9999 d.C.</para>
    <para>
     Anche se questa funzione pu&ograve; gestire date fino al 4714
     a.C., qusto utilizzo potrebbe non avere senso. Il calendario Gregorian fu
     istituito il 15 Ottobre 1582 (o 5 Ottobre 1582 nel
     calendario Giuliano). Alcune nazioni non lo accettarono per un lungo
     periodo. Per esempio, il Regno Unito si convert&igrave; nel 1752, L'Unione Sovietica nel in 1918
     e la Grecia nel 1923. La maggior parte delle nazioni Europee usavano il calendario
     Giuliano pdima del Gregoriano.
     <example>
      <title>Calendar functions</title>
      <programlisting role="php">
<![CDATA[
<?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>
     Converte un Giorno Giuliano in una data Giuliana
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>jdtojulian</methodname>
      <methodparam><type>int</type><parameter>giornogiuliano</parameter></methodparam>
     </methodsynopsis>
    <para>
     Converte un Giorno Giuliano in una stringa contenente la data
     del calendario Giuliano nel formato "mese/giorno/anno".
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.juliantojd">
   <refnamediv>
    <refname>JulianToJD</refname> 
    <refpurpose>
     Converte una data Giuliana in un Giorno Giuliano
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>int</type><methodname>juliantojd</methodname>
      <methodparam><type>int</type><parameter>mese</parameter></methodparam>
      <methodparam><type>int</type><parameter>giorno</parameter></methodparam>
      <methodparam><type>int</type><parameter>anno</parameter></methodparam>
     </methodsynopsis>
    <para>
     L'intervallo valido per il Calendario Giuliano &egrave; dal 4713 a.C. al 9999 d.C.
    </para>
    <para>
     Anche se questa funzione pu&ograve; gestire date fino al 4713
     a.C., questo utilizzo potrebbe non avere senso. Il calendario fu creato nel
     46 a.C., ma i dettagli non furono perfezionati fino almeno al 8 d.D.,
     e forse anche fino al quarto secolo. Inoltre, l'inizio dell'anno
     variava da una cultura all'altrar - non tutti accettavano
     Gennaio come primo mese.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.jdtojewish">
   <refnamediv>
    <refname>JDToJewish</refname>
    <refpurpose>
     Converte un Giorno Giuliano nel Calendario Giudeo
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>jdtojewish</methodname>
      <methodparam><type>int</type><parameter>giornogiuliano</parameter></methodparam>
     </methodsynopsis>
    <para>
     Converte un Giorno Giuliano nel Calendario Giudeo.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.jewishtojd">
   <refnamediv>
    <refname>JewishToJD</refname> 
    <refpurpose>
     Converte una data del Calendario Giudeo in Giorno Giuliano
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>int</type><methodname>jewishtojd</methodname>
      <methodparam><type>int</type><parameter>mese</parameter></methodparam>
      <methodparam><type>int</type><parameter>giorno</parameter></methodparam>
      <methodparam><type>int</type><parameter>anno</parameter></methodparam>
     </methodsynopsis>
    <para>
     Anche se questa funzione pu&ograve; gestire date fino all'anno 1
     (3761 B.C.), questo utilizzo potrebbe non avere senso. Il calendario Giudeo &egrave;
     usato da parecchie migliaia di anni, ma nei primi tempi non c'era una 
     formula per stabilire l'inizio del mese. Il nuovo mese iniziava quando si vedeva 
     la prima volta la luna.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.jdtofrench">
   <refnamediv>
    <refname>JDToFrench</refname>
    <refpurpose>
     Converte un Giorno Giuliano in una data del Calendario Repubblicano Francese
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>jdtofrench</methodname>
      <methodparam><type>int</type><parameter>giornogiuliano</parameter></methodparam>
     </methodsynopsis>
    <para>
     Converte un Giorno Giuliano in una data del calendario Repubblicano Francese.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.frenchtojd">
   <refnamediv>
    <refname>FrenchToJD</refname>
    <refpurpose>
     Converte una data del Calendario Repubblicano Francese in un Giorno
     Giuliano
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>frenchtojd</methodname>
      <methodparam><type>int</type><parameter>mese</parameter></methodparam>
      <methodparam><type>int</type><parameter>giorno</parameter></methodparam>
      <methodparam><type>int</type><parameter>anno</parameter></methodparam>
     </methodsynopsis>
    <para>
     Converte una data del Calendario Repubblicano Francese in un Giorno
     Giuliano.
    </para>
    <para>
     Queste funzioni convertono solo le date con gli anni dal 1 al 14
     (date Gregoriane dal 22 Settmbre 1792 al 22 Settembre
     1806). Questo copre pi&ugrave; del periodo in cui fu in uso il
     calendario.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.jdmonthname">
   <refnamediv>
    <refname>JDMonthName</refname>
    <refpurpose>Restituisce il nome di un mese</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>jdmonthname</methodname>
      <methodparam><type>int</type><parameter>giornogiuliano</parameter></methodparam>
      <methodparam><type>int</type><parameter>modo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Restituisce una stringa contenente il nome di un mese.
     <parameter>modo</parameter> dice alla funzione verso quale calendario
     convertire il giorno Giuliano, e che tipo di nome di mese
     restituire.
     <table>
      <title>Modi del Calendario</title>
      <tgroup cols="3">
       <thead>
        <row>
         <entry>Modo</entry>
         <entry>Significato</entry>
         <entry>Valori</entry>
        </row>
       </thead>
       <tbody>
        <row>
         <entry>0</entry>
         <entry>Gregoriano abbreviato</entry>
         <entry>Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec</entry>
        </row>
        <row>
         <entry>1</entry>
         <entry>Gregoriano</entry>
         <entry>January, February, March, April, May, June, July, August, September, October, November, December</entry>
        </row>
        <row>
         <entry>2</entry>
         <entry>Guliano abbreviato</entry>
         <entry>Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec</entry>
        </row>
        <row>
         <entry>3</entry>
         <entry>Guliano</entry>
         <entry>January, February, March, April, May, June, July, August, September, October, November, December</entry>
        </row>
        <row>
         <entry>4</entry>
         <entry>Giudeo</entry>
         <entry>Tishri, Heshvan, Kislev, Tevet, Shevat, AdarI, AdarII, Nisan, Iyyar, Sivan, Tammuz, Av, Elul</entry>
        </row>
        <row>
         <entry>5</entry>
         <entry>Repubblicano Francese</entry>
         <entry>Vendemiaire, Brumaire, Frimaire, Nivose, Pluviose, Ventose, Germinal, Floreal, Prairial, Messidor, Thermidor, Fructidor, Extra</entry>
        </row>
       </tbody>
      </tgroup>
     </table>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.jddayofweek">
   <refnamediv>
    <refname>JDDayOfWeek</refname>
    <refpurpose>Restituisce il giorno della settimana</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>mixed</type><methodname>jddayofweek</methodname>
      <methodparam><type>int</type><parameter>giornogiuliano</parameter></methodparam>
      <methodparam><type>int</type><parameter>modo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Restituisce il giorno della settimana.  Pu&ograve; restituire una stringa o un intero
     a seconda del modo.
     <table>
      <title>Modi</title>
      <tgroup cols="2">
       <thead>
        <row>
         <entry>Modo</entry>
         <entry>Significato</entry>
        </row>
       </thead>
       <tbody>
        <row>
         <entry>0</entry> 
         <entry>
          Restiutuisce il numero del giorno come intero (0=domenica, 1=lunedi&igrave;, etc)
         </entry>
        </row>
        <row>
         <entry>1</entry> 
         <entry>
          Restituisce una stringa contenente il giorno della settimana
          (in inglese-gregoriano)
         </entry>
        </row>
        <row>
         <entry>2</entry> 
         <entry>
          Restituisce una stringa contenente il giorno della settimana abbreviato
          (in inglese-gregoriano)
         </entry>
        </row>
       </tbody>
      </tgroup>
     </table>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.easter-date">
   <refnamediv>
    <refname>easter_date</refname>
    <refpurpose>
     Restituisce un timestamp UNIX della mezzanotte del giorno di Pasqua di un dato anno
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>int</type><methodname>easter_date</methodname>
      <methodparam><type>int</type><parameter>anno</parameter></methodparam>
     </methodsynopsis>
    <para>
     Restituisce il timestamp  UNIX corrispondente alla mezzanotte del giorno di Pasqua
     dell'anno specificato. Se non &egrave; specificato l'anno, si assume l'anno
     corrente.
    </para>
    <para>
     <emphasis>Attenzione:</emphasis> Questa funzione gererer&agrave;
     un allarme (warning) se  l'anno &egrave; fuori dall'escursione di validit&agrave; dei timestamp UNIX
     (cio&egrave; prima del 1970 o dopo il 2037).
     <example>
      <title>esempio di <function>easter_date</function></title>
      <programlisting role="php">
<![CDATA[
echo date ("M-d-Y", easter_date(1999));        /* "Apr-04-1999" */
echo date ("M-d-Y", easter_date(2000));        /* "Apr-23-2000" */
echo date ("M-d-Y", easter_date(2001));        /* "Apr-15-2001" */
]]>
      </programlisting>
     </example>
    </para>
    <para>
     La data della Pasqua fu definita dal Concilio di Nicea nel
     325 d.C. come la Domenica successiva alla prima luna piena dopo
     l'Equinozio di Primavera. Si assume che l'Equinozio cada sempre
     il 21 Marzo, quindi il calcolo si riduce alla determinazione della data
     della luna piena e la data della Domenica seguente.
     L'algoritmo qui usato fu proposto attorno all'anno 532 d.C. da
     Dionysius Exiguus (Dionigi il Piccolo). Nel Calendario Giuliano (for years before
     1753) un semplice ciclo di 19 anni &egrave; usato per traciare le fasi della
     Luna. Nel Calendario Gregoriano (per gli anni dopo il 1753 -
     ideato da Clavius e Lilius, e introdotto da Papa Gregorio
     XIII nell'Ottobre 1582, e in Gran Bretagna e nelle sue colonie nel
     Settembre 1752) due fattori correttivi sono aggiunti per rendere
     pi&ugrave; accurato il ciclo.
    </para>
    <para>
     (Il codice &egrave; basato su un programma in C di Simon Kershaw,
     &lt;webmaster@ely.anglican.org&gt;)
    </para>
    <para>
     Vedere <function>easter_days</function> per il calcolo della Pasqua
     prima del 1970 o dopo il 2037.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.easter-days">
   <refnamediv>
    <refname>easter_days</refname>
    <refpurpose>
     Restituisce il numero di giorni tra il 21 Marzo e Pasqua, dato un
     anno
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>int</type><methodname>easter_days</methodname>
      <methodparam><type>int</type><parameter>anno</parameter></methodparam>
     </methodsynopsis>
    <para>
     Restituisce il numero di giorni tra il 21 Marzo e Pasqua
     per un dato anno. Se l'ano non &egrave; specificato, si assume
     l'anno corrente.
    </para>
    <para>
     Questa funzione pu&ograve; essere usata al posto di
     <function>easter_date</function> per calcolare la Pasqua per gli anni
     che cadono fuori dalla gamma di validit&agrave; dei timestamp UNIX (cio&egrave; prima del 1970
     o dopo il 2037).
     <example>
      <title>esempio di <function>easter_days</function></title>
      <programlisting role="php">
<![CDATA[
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>
     La data della Pasqua fu definita dal Concilio di Nicea nel
     325 d.C. come la Domenica successiva alla prima luna piena dopo
     l'Equinozio di Primavera. Si assume che l'Equinozio cada sempre
     il 21 Marzo, quindi il calcolo si riduce alla determinazione della data
     della luna piena e la data della Domenica seguente.
     L'algoritmo qui usato fu proposto attorno all'anno 532 d.C. da
     Dionysius Exiguus (Dionigi il Piccolo). Nel Calendario Giuliano (for years before
     1753) un semplice ciclo di 19 anni &egrave; usato per traciare le fasi della
     Luna. Nel Calendario Gregoriano (per gli anni dopo il 1753 -
     ideato da Clavius e Lilius, e introdotto da Papa Gregorio
     XIII nell'Ottobre 1582, e in Gran Bretagna e nelle sue colonie nel
     Settembre 1752) due fattori correttivi sono aggiunti per rendere
     pi&ugrave; accurato il ciclo.
    </para>
    <para>
     (Il codice &egrave; basato su un programma in C di Simon Kershaw,
     &lt;webmaster@ely.anglican.org&gt;)
    </para>
    <para>
     Vedere anche <function>easter_date</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.unixtojd">
   <refnamediv>
    <refname>unixtojd</refname>
    <refpurpose>Converte un timestamp UNIX in un Giorno Giuliano</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>int</type><methodname>unixtojd</methodname>
      <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Restituisce il Giorno Giuliano di un <parameter>timestamp</parameter> UNIX
     (secondi dal 1/1/1970), o del giorno corrente se
     <parameter>timestamp</parameter> non &egrave; specificato.
    </para>
    <para>
     Vedere anche <function>jdtounix</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.jdtounix"> 
   <refnamediv>
    <refname>jdtounix</refname>
    <refpurpose>Converte un Giorno Giuliano in un timestamp UNIX</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>int</type><methodname>jdtounix</methodname>
      <methodparam><type>int</type><parameter>giornogiuliano</parameter></methodparam>
     </methodsynopsis>
    <para>
     Questa funzione restituisce un timestamp UNIX corrispondente al
     Giorno Giuliano <parameter>giornogiuliano</parameter> o &false; se
     <parameter>giornogiuliano</parameter> non &egrave; all'interno della gamma UNIX 
     (anni Gregoriani tra il 1970 e il 2037 o 2440588 &lt;=
     <parameter>giornogiuliano</parameter> &lt;= 2465342 )
    </para>
    <para>
     See also <function>unixtojd</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.cal-days-in-month"> 
   <refnamediv>
    <refname>cal_days_in_month</refname>
    <refpurpose>Restituisce il numero di giorni di un mese per un dato anno e calendario</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>int</type><methodname>cal_days_in_month</methodname>
      <methodparam><type>int</type><parameter>calendario</parameter></methodparam>
      <methodparam><type>int</type><parameter>mese</parameter></methodparam>
      <methodparam><type>int</type><parameter>anno</parameter></methodparam>
     </methodsynopsis>
    <para>
     Questa funzione restituisce il numero di giorni coe compongono il
     <parameter>mese</parameter> dell'<parameter>anno</parameter> nel
     <parameter>calendar</parameter> specificato.
    </para>
    <para>
     Vedere anche  <function>jdtounix</function>.
    </para>
   </refsect1>
  </refentry>
  

  <refentry id='function.cal-to-jd'>
   <refnamediv>
    <refname>cal_to_jd</refname>
    <refpurpose>Converte da un calendario a un Giorno Giuliano</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>int</type><methodname>cal_to_jd</methodname>
      <methodparam><type>int</type><parameter>calendario</parameter></methodparam>
      <methodparam><type>int</type><parameter>mese</parameter></methodparam>
      <methodparam><type>int</type><parameter>giorno</parameter></methodparam>
      <methodparam><type>int</type><parameter>anno</parameter></methodparam>
     </methodsynopsis>
    <para>
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.cal-from-jd'>
   <refnamediv>
    <refname>cal_from_jd</refname>
    <refpurpose>Converte dal Giorno Giuliano ad un calendario e restituisce informazioni estese</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>array</type><methodname>cal_from_jd</methodname>
      <methodparam><type>int</type><parameter>giornogiuliano</parameter></methodparam>
      <methodparam><type>int</type><parameter>calendario</parameter></methodparam>
     </methodsynopsis>
    <para>
    </para>
   </refsect1>
  </refentry>


  <refentry id='function.cal-info'>
   <refnamediv>
    <refname>cal_info</refname>
    <refpurpose>Restituisce informazioni su un particolare calendario</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>array</type><methodname>cal_info</methodname>
      <methodparam><type>int</type><parameter>calendario</parameter></methodparam>
     </methodsynopsis>
    <para>
    </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:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->