archived-doc-it/reference/datetime/functions/date.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- splitted from ./it/functions/datetime.xml, last change in rev 1.1 -->
<!-- last change to 'date' in en/ tree in rev 1.2 -->
<!-- EN-Revision: 1.2 Maintainer: curcio_it Status: ready -->
<!-- OLD-Revision: 1.71/EN.1.2 -->
  <refentry id="function.date">
   <refnamediv>
    <refname>date</refname>
    <refpurpose>Formatta una data o orario locale</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>date</methodname>
      <methodparam><type>string</type><parameter>formato</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
        timestamp
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     Restituisce una stringa formattata in accordo con il formato della stringa usato nell'
     intero <parameter>timestamp</parameter> o nell'attuale orario locale
     se timestamp non è assegnato.
     <note>
      <para>
       Il valido intervallo del timestamp è abitualmente da Fri, 13 Dec
       1901 20:45:54 GMT a Tue, 19 Jan 2038 03:14:07 GMT. (Queste
       date corrispondono al valore minimo e al massimo per
       un intero segnato a 32-bit.)
      </para>
      <para>
       Per generare un timestamp da una stringa rappresentante la data,
       devi sapere usare <function>strtotime</function>. In aggiunta, dei
       databases hanno funzioni che convertono i loro formati di data in timestamps
       (come la funzione di MySQL, UNIX_TIMESTAMP).
      </para>
     </note>
    </para>
    <para>
     I seguenti caratteri sono utilizzati nella stringa formato:
     <itemizedlist>
      <listitem>
       <simpara>
        a - "am" o "pm"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        A - "AM" o "PM"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        B - Swatch Internet time
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        d - giorno del mese, 2 cifre senza tralasciare gli zero; i.e. "01"
        a "31"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        D - giorno della settimana, testuale, 3 lettere; i.e. "Fri"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        F - mese, testuale, long; i.e. "January"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        g - ora, formato a 12-ore senza eventuali zero; i.e. "1" a
        "12"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        G - ora, formato a 24-ore senza eventuali zero; i.e. "0" a
        "23"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        h - ora, formato a 12-ore; i.e. "01" a "12"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        H - ora, formato a 24-ore; i.e. "00" a "23"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        i - minuti; i.e. "00" a "59"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        I (i grande) - "1" se c'è l'ora legale, "0" altrimenti.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        j - giorno del mese senza eventuali zero; i.e. "1" a "31"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        l ('L' piccola) - giorno della settimana, testuale, long;
        i.e. "Friday"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        L - valore booleano per stabilire se è un anno bisestile; i.e. "0" o "1"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        m - mese; i.e. "01" a "12"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        M - mese, testuale, 3 lettere; i.e. "Jan"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        n - mese senza eventuali zero; i.e. "1" a "12"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        O - Differenza in ore dal fuso orario Greenwich; i.e. "+0200"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        r - Data formattata RFC 822; i.e. "Thu, 21 Dec 2000 16:01:07 +0200"
        (aggiunto nel PHP 4.0.4)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        s - secondi; i.e. "00" a "59"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        S - Suffisso ordinale Inglese per i giorni del mese, 2 caratteri;
        i.e. "th", "nd"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        t - numero di giorni del mese dato; i.e. "28" a "31"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        T - Fuso orario di questo computer; i.e. "MDT"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        U - secondi dall'epoca since the epoch
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        w - giorno della settimana, numerico, i.e. "0" (Domenica) a "6"
        (Sabato)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        W - ISO-8601 Numero della settimana dell'anno, le settimane iniziano il lunedì (aggiunto in PHP 4.1.0)
        (Sabato)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        Y - anno, 4 cifre; i.e. "1999"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        y - anno, 2 cifre; i.e. "99"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        z - giorno dell'anno; i.e. "0" a "365"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        Z - Fuso orario in secondi (i.e. "-43200" a "43200"). Il fuso orario
        ad ovest dell'UTC è sempre negativo, e per
        quelli ad est è sempre positivo.
       </simpara>
      </listitem>
     </itemizedlist>
     Caratteri non utilizzati nella stringa del formato saranno scritti
     come sono.  Il formato "Z" restituirà sempre "0" quando si usa
     <function>gmdate</function>.
    </para>
    <para>
     <example>
      <title>Esempio di <function>date</function></title>
      <programlisting role="php">
<![CDATA[
echo date ("l dS of F Y h:i:s A");
echo "July 1, 2000 is on a " . date ("l", mktime(0,0,0,7,1,2000));
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Puoi utilizzare un carattere utilizzabile nella stringa del formato come carattere normale
     facendolo semplicemente precedere dal carattere di escape, il backslash. Se il carattere con un
     backslash è ancora una sequenza speciale, devi inserire di nuovo il carattere di escape per il
     backslash.
     <example>
      <title>Caratteri di escape in <function>date</function></title>
      <programlisting role="php">
<![CDATA[
echo date("l \\t\h\e jS"); // scrive qualcosa tipo 'Saturday the 8th'
]]>
      </programlisting>
     </example>
    </para>
    <para>
     &Egrave; possibile usare <function>date</function> e 
     <function>mktime</function> assieme per cercare delle date nel futuro
     o nel passato. 
     <example>
      <title>
       Esempio di <function>date</function> e 
       <function>mktime</function>
      </title>
      <programlisting role="php">
<![CDATA[
$tomorrow  = mktime (0,0,0,date("m")  ,date("d")+1,date("Y"));
$lastmonth = mktime (0,0,0,date("m")-1,date("d"),  date("Y"));
$nextyear  = mktime (0,0,0,date("m"),  date("d"),  date("Y")+1);
]]>
      </programlisting>
     </example>
     <note>
      <para>
       Questo può essere più affidabile della semplice addizione e sottrazione del numero 
       di secondi in un giorno o mese a un timestamp a causa del daylight savings
       time.
      </para>
     </note>
    </para>
    <para>
     Alcuni esempi della formattazione di <function>date</function>. Nota che
     puoi scrivere qualsiasi altro carattere senza escape, il quale attualmente
     non dovrebbe produrre risultati indesiderati, ma
     altri caratteri potrebbero essere assegnati come caratteri della stringa di formattazione nelle prossime versioni del PHP.
     Quando si utilizza il carattere di escape, assicurati di usare un singolo apice per prevenire che caratteri
     come \n facciano iniziare una nuova linea.
     <example>
      <title>
       Formattazione con <function>date</function>
      </title>
      <programlisting role="php">
<![CDATA[
/* Today is March 10th, 2001, 5:16:18 pm */
$today = date("F j, Y, g:i a");                 // March 10, 2001, 5:16 pm
$today = date("m.d.y");                         // 03.10.01
$today = date("j, n, Y");                       // 10, 3, 2001
$today = date("Ymd");                           // 20010310
$today = date('h-i-s, j-m-y, it is w Day z ');  // 05-16-17, 10-03-01, 1631 1618 6 Fripm01
$today = date('\i\t \i\s \t\h\e jS \d\a\y.');   // It is the 10th day.
$today = date("D M j G:i:s T Y");               // Sat Mar 10 15:16:08 MST 2001
$today = date('H:m:s \m \i\s\ \m\o\n\t\h');     // 17:03:17 m is month
$today = date("H:i:s");                         // 17:16:17
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Per formattare le date in lingue diverse dall'inglese, dovresti usare le funzioni
     <function>setlocale</function> e 
     <function>strftime</function>.
    </para>
    <para>
     Guarda anche <function>getlastmod</function>, <function>gmdate</function>,
     <function>mktime</function>, <function>strftime</function>
     e <function>time</function>.
    </para>
   </refsect1>
  </refentry>

<!-- 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
-->