cucinato Mon Dec 17 04:44:18 2001 EDT Modified files: /phpdoc/it/functions calendar.xml Log: Added first IT translation
Index: phpdoc/it/functions/calendar.xml diff -u /dev/null phpdoc/it/functions/calendar.xml:1.8 --- /dev/null Mon Dec 17 04:44:18 2001 +++ phpdoc/it/functions/calendar.xml Mon Dec 17 04:44:15 2001 @@ -0,0 +1,660 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.19 Maintainer: cucinato Status: ready --> + <reference id="ref.calendar"> + <title>Funzioni Calendar</title> + <titleabbrev>Calendar</titleabbrev> + + <partintro> + <para> + Le funzioni di calendario sono disponibili solo se è stata compilata + l'estensione calendar, che si trova nelle cartelle "dl" o "ext" + dei sorgenti PHP. + Leggere il file README prima di usarla. + </para> + <para> + L'estensione calendar presenta una serie di funzioni che semplificano + la conversione tra differenti formati di calendario. Il formato intermedio + o standard è basato sul Conteggio Quotidiano Giuliano. Il Conteggio + Giuliano è 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 + Giuliano, poi nel sistema di calendario scelto. Il Conteggio Quotidiano + Giuliano è molto diverso dal Calendario Giulano! Per maggiori + informazioni sui sistemi di calendario guardare <ulink + url="&url.calendar;">&url.calendar;</ulink>. Parti di questa + pagina sono inclusi in queste istruzioni, citate tra virgolette. + </para> + </partintro> + + <refentry id="function.jdtogregorian"> + <refnamediv> + <refname>JDToGregorian</refname> + <refpurpose>Converte il Conteggio Giuliano in data Gregoriana</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>jdtogregorian</function></funcdef> + <paramdef>int <parameter>giornogiuliano</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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 ua data Gregoriana in un Giorno Giuliano + </refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>gregoriantojd</function></funcdef> + <paramdef>int <parameter>mese</parameter></paramdef> + <paramdef>int <parameter>giorno</parameter></paramdef> + <paramdef>int <parameter>anno</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + L'intervallo valido per il Calendario Gregoriano è dal 4714 a.C. al 9999 +d.C.</para> + <para> + Anche se questo software può 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ì 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> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>jdtojulian</function></funcdef> + <paramdef>int <parameter>giornogiuliano</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>juliantojd</function></funcdef> + <paramdef>int <parameter>mese</parameter></paramdef> + <paramdef>int <parameter>giorno</parameter></paramdef> + <paramdef>int <parameter>anno</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + L'intervallo valido per il Calendario Giuliano è dal 4713 a.C. al 9999 +d.C. + </para> + <para> + Anche se questo software può 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> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>jdtojewish</function></funcdef> + <paramdef>int <parameter>giornogiuliano</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>jewishtojd</function></funcdef> + <paramdef>int <parameter>mese</parameter></paramdef> + <paramdef>int <parameter>giorno</parameter></paramdef> + <paramdef>int <parameter>anno</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Valid Range Although this software can handle dates all the way + back to the year 1 (3761 B.C.), such use may not be meaningful. + </para> + <para> + Il calendario Giudeo è 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 + observed. + </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> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>jdtofrench</function></funcdef> + <paramdef>int <parameter>giornogiuliano</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>frenchtojd</function></funcdef> + <paramdef>int <parameter>mese</parameter></paramdef> + <paramdef>int <parameter>giorno</parameter></paramdef> + <paramdef>int <parameter>anno</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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ù del periodo in cui fu in uso il + calendario. + </para> + </refsect1> + </refentry> + + <refentry id="function.jdmonthname"> + <refnamediv> + <refname>JDMonthName</refname> + <refpurpose>Resituisce il nome di un mese</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>jdmonthname</function></funcdef> + <paramdef>int <parameter>giornogiuliano</parameter></paramdef> + <paramdef>int <parameter>modo</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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="2"> + <thead> + <row> + <entry>Modo</entry> + <entry>Significato</entry> + </row> + </thead> + <tbody> + <row> + <entry>0</entry> + <entry>Gregoriano abbreviato</entry> + </row> + <row> + <entry>1</entry> + <entry>Gregoriano</entry> + </row> + <row> + <entry>2</entry> + <entry>Guliano abbreviato</entry> + </row> + <row> + <entry>3</entry> + <entry>Guliano</entry> + </row> + <row> + <entry>4</entry> + <entry>Giudeo</entry> + </row> + <row> + <entry>5</entry> + <entry>Repubblicano Francese</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> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>jddayofweek</function></funcdef> + <paramdef>int <parameter>giornogiuliano</parameter></paramdef> + <paramdef>int <parameter>modo</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Restituisce il giorno della settimana. Può 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ì, 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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>easter_date</function></funcdef> + <paramdef>int <parameter>anno</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Restituisce il timestamp UNIX corrispondente alla mezzanotte del giorno di +Pasqua + dell'anno specificato. Se non è specificato l'anno, si assume l'anno + corrente. + </para> + <para> + <emphasis>Attenzione:</emphasis> Questa funzione gerererà + un allarme (warning) se l'anno è fuori dall'escursione di +validità dei timestamp UNIX + (cioè 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 è 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ù accurato il ciclo. + </para> + <para> + (Il codice è basato su un programma in C di Simon Kershaw, + <[EMAIL PROTECTED]>) + </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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>easter_days</function></funcdef> + <paramdef>int <parameter>anno</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Restituisce il numero di giorni tra il 21 Marzo e Pasqua + per un dato anno. Se l'ano non è specificato, si assume + l'anno corrente. + </para> + <para> + Questa funzione può essere usata al posto di + <function>easter_date</function> per calcolare la Pasqua per gli anni + che cadono fuori dalla gamma di validità dei timestamp UNIX (cioè +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 è 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ù accurato il ciclo. + </para> + <para> + (Il codice è basato su un programma in C di Simon Kershaw, + <[EMAIL PROTECTED]>) + </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 una Giorno Giuliano</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>unixtojd</function></funcdef> + <paramdef>int + <parameter><optional>timestamp</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <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 è specificato. + </para> + <para> + Vedere anche <function>jdtounix</function>. + </para> + <note> + <para> + Questa funzione è disponibile solo nelle versioni di PHP successive alla +4RC1. + </para> + </note> + </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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>jdtounix</function></funcdef> + <paramdef>int <parameter>giornogiuliano</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Questa funzione restituisce un timestamp UNIX corrispondente al + Giorno Giuliano <parameter>giornogiuliano</parameter> o &false; se + <parameter>giornogiuliano</parameter> non è all'interno della gamma UNIX + (anni Gregoriani tra il 1970 e il 2037 o 2440588 <= + <parameter>giornogiuliano</parameter> <= 2465342 ) + </para> + <para> + See also <function>jdtounix</function>. + </para> + <note> + <para> + Questa funzione è disponibile solo nelle versioni di PHP successive alla +4RC1. + </para> + </note> + </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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>cal_days_in_month</function></funcdef> + <paramdef>int <parameter>calendario</parameter></paramdef> + <paramdef>int <parameter>mese</parameter></paramdef> + <paramdef>int <parameter>anno</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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> + <note> + <para> + Questa funzione è disponibile solo nelle versioni di PHP successive alla +4RC1. + </para> + </note> + </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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>cal_to_jd</function></funcdef> + <paramdef>int <parameter>calendario</parameter></paramdef> + <paramdef>int <parameter>mese</parameter></paramdef> + <paramdef>int <parameter>giorno</parameter></paramdef> + <paramdef>int <parameter>anno</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>cal_from_jd</function></funcdef> + <paramdef>int <parameter>giornogiuliano</parameter></paramdef> + <paramdef>int <parameter>calendario</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>cal_info</function></funcdef> + <paramdef>int <parameter>calendario</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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 +-->