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

<?xml version="1.0" encoding="UTF-8"?>
<!-- splitted from ./it/functions/datetime.xml, last change in rev 1.1 -->
<!-- last change to 'strftime' in en/ tree in rev 1.2 -->
<!-- EN-Revision: n/a Maintainer: curcio_it Status: ready -->
<!-- OLD-Revision: 1.71/EN.1.2 -->
  <refentry xml:id="function.strftime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <refnamediv>
    <refname>strftime</refname>
    <refpurpose>
     Formatta una data/orario locale accordandola/o alle impostazioni locali according to locale settings
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</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>
     Restituisce una stringa formattata in accordo con la stringa del formato data
     usando il parametro dato <parameter>timestamp</parameter> o l'attuale 
     orario locale se non è stato dato il timestamp. I nomi di mesi e giorni della settimana e 
     le altre stringhe dipendenti dalla lingua rispettano le attuali impostazioni locali
     con <function>setlocale</function>.
    </para>
    <para>
     Le seguenti sequenze di caratteri sono utilizzate nella stringa del 
     formato:
     <itemizedlist>
      <listitem>
       <simpara>
        %a - Nome del giorno della settimana abbreviato in accordo con i parametri locali
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %A - Nome completo del giorno della settimana in accordo con i parametri locali
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %b - Nome del mese abbreviato in accordo con i parametri locali
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %B - Nome completo del mese in accordo con i parametri locali
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %c - Rappresentazione preferita di data e orario per le attuali
        impostazioni locali
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %C - numero del secolo (l'anno diviso 100 e troncato in
        un intero, intervallo tra 00 e 99)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %d - giorno del mese come numero decimale (intervallo tra 01 e 31)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %D - come %m/%d/%y
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %e - giorno del mese come numero decimale, un singolo carattere è 
        preceduto da uno spapzio (intervallo tra ' 1' e '31')
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %g - come %G, ma senza il secolo.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %G - L'anno a 4 cifre corrispondente al numero di setitmana ISO (vedi %V).
        Questa ha lo stesso formato e valore di %Y, eccetto che se il numero di
        settimana ISO appartiene al precedente o prossimo anno, è invece utilizzato l'anno 
        attuale.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %h - come %b
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %H - ora come numero decimale usando il sistema a 24 ore (intervallo tra 00
        e 23)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %I - ora come numero decimale usando il sistema a 12 ore (intervallo tra 01
        e 12)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %j - giorno dell'anno come numero decimale (intervallo tra 001 e 366)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %m - mese come numero decimale (intervallo tra 01 e 12)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %M - minuto come numero decimale 
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %n - carattere di nuova linea
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %p - entrambi `am' o `pm' accordati a un valore di tempo dato, o
        alle stringhe corrispondenti per le impostazioni locali
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %r - orario in notazione a.m. e p.m
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %R - orario nella notazione a 24 ore
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %S - secondi come numero decimale
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %t - Carattere di tabella
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %T - orario attuale, identico a %H:%M:%S
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %u - giorno della settimana come numero decimale [1,7], dove 1 rappresenta il
        Lunedì
       </simpara>
       <warning>
        <simpara>
         Sun Solaris sembra far iniziare con la Domenica a come 1
         sebbe la ISO 9889:1999 (l'attuale standard di C) specifica
         chiaramente che dovrebbe iniziare dal Lunedì.
        </simpara>
       </warning>
      </listitem>
      <listitem>
       <simpara>
        %U - numero della settimana dell'anno in corso come numero decimale,
        iniziando dalla prima Domenica come primo giorno della prima
        settimana
       </simpara>
      </listitem>
      <listitem>
       <simpara> 
        %V - Il numero di settimana ISO 8601:1988 dell'anno attuale come numero decimale, 
        intervallo tra 01 e 53, dove la settimana 1 è la prima
        settimana che ha almeno 4 giorni dell'attuale anno, e con
        il Lunedì come primo giorno della settimana. (Utilizza %G o %g per l'anno
        componente che corrisponde al numero di settimana per il timestamp
        specificato.)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %W - numero della settimana dell'attuale anno come numero decimale,
        partendo con il primo Lunedì come primo giorno della prima
        settimana
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %w - giorno della settimana come decimale, dove la Domenica è 0
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %x - visualizzazione della data preferita dalle impostazioni del sistema locale
        senza orario
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %X - visualizzazione dell'orario preferito dalle impostazioni del sistema locale
        senza data
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %y - anno come numero decimale senza secolo (intervallo tra 00 e
        99)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %Y - anno come numero decimale incluso il secolo
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %Z - fuso orario o abbreviazione
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        %% - il carattere `%'
       </simpara>
      </listitem>
     </itemizedlist>
     <note>
      <para>
       Non tutte le sequenze di caratteri potrebbero essere supportate dalla tua libreria locale
       di C, in tal caso la funzione <function>strftime</function>
       non sarà supportata dal PHP. Questo significa che %T e %D non
       funzioneranno sotto Windows.
      </para>
     </note>
     <example>
      <title>Esempio di <function>strftime</function></title>
      <programlisting role="php">
<![CDATA[
setlocale (LC_TIME, "C");
print (strftime ("%A in Finlandese è "));
setlocale (LC_TIME, "fi_FI");
print (strftime ("%A, in Francese "));
setlocale (LC_TIME, "fr_FR");
print (strftime ("%A e in Italiano "));
setlocale (LC_TIME, "it_IT");
print (strftime ("%A.\n"));
]]>
      </programlisting>
     </example>
     Questo esempio funziona se hai le ripettive impostazioni di lingua installate 
     nel tuo sistema.
    </para>
    <para>
     Guarda anche <function>setlocale</function> e
     <function>mktime</function> e le<link xlink:href="&spec.strftime;">
     specifiche dell' Open Group per
     <function>strftime</function></link>.
    </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:"~/.phpdoc/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
-->