cvs: phpdoc /it/functions datetime.xml
| From: | Simone Cortesi | Date: | Wed, 27 Mar 2002 03:11:24 +0000 |
| Subject: | cvs: phpdoc /it/functions datetime.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969343573@lists.php.net to get a copy of this message | ||
cortesi Tue Mar 26 22:11:24 2002 EDT
Modified files:
/phpdoc/it/functions datetime.xml
Log:
adding translation by curcio_it
Index: phpdoc/it/functions/datetime.xml diff -u /dev/null phpdoc/it/functions/datetime.xml:1.11 --- /dev/null Tue Mar 26 22:11:24 2002 +++ phpdoc/it/functions/datetime.xml Tue Mar 26 22:11:23 2002 @@ -0,0 +1,1170 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.69 Maintainer: curcio_it Status: ready --> + <reference id="ref.datetime"> + <title>Funzioni di Data e Orario</title> + <titleabbrev>Data/orario</titleabbrev> + + <refentry id="function.checkdate"> + <refnamediv> + <refname>checkdate</refname> + <refpurpose>Verifica una data/orario gragoriana/o</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>bool</type><methodname>checkdate</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> + Restituisce &true; se la data inserita è valida; altrimenti restituisce &false;. + Controlla la validità di una data formata dagli argomenti. Una data + è considerata valida se: + <itemizedlist> + <listitem> + <simpara> + anno è compreso tra 1 e 32767 + </simpara> + </listitem> + <listitem> + <simpara> + mese è compreso tra 1 e 12 + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>Giorno</parameter> è compreso tra il numero dei giorni possibile + per il <parameter>mese</parameter> dato. Gli + <parameter>anno</parameter>(i) bisestili sono presi in considerazione. + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + Guarda anche <function>mktime</function> e <function>strtotime</function>. + </para> + </refsect1> + </refentry> + + <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>data</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 del mese, 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 nel 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>data</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> + È possibile usare <function>date()</function> e <function>mktime()</function> + assieme per cercare una data ne 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> + <function>date</function> Formatting + </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> + + <refentry id="function.getdate"> + <refnamediv> + <refname>getdate</refname> + <refpurpose>Riceve informazioni su data/orario</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>array</type><methodname>getdate</methodname> + <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam> + </methodsynopsis> + <para> + Restituisce un array associativo contenente le informazioni sulla data del + <parameter>timestamp</parameter>, o dell'attuale orario locale se + non è stato assegnato timestamp, con i seguenti elementi di + array: + <itemizedlist> + <listitem> + <simpara> + "seconds" - secondi + </simpara> + </listitem> + <listitem> + <simpara> + "minutes" - minuti + </simpara> + </listitem> + <listitem> + <simpara> + "hours" - ore + </simpara> + </listitem> + <listitem> + <simpara> + "mday" - giorno del mese + </simpara> + </listitem> + <listitem> + <simpara> + "wday" - giorno della settimana, numerico : da 0 come Domenica a 6 come Sabato + </simpara> + </listitem> + <listitem> + <simpara> + "mon" - mese, numerico + </simpara> + </listitem> + <listitem> + <simpara> + "year" - anno, numerico + </simpara> + </listitem> + <listitem> + <simpara> + "yday" - giorno dell'anno, numerico; i.e. "299" + </simpara> + </listitem> + <listitem> + <simpara> + "weekday" - giorno della settimana, testuale, per intero; i.e. "Friday" + </simpara> + </listitem> + <listitem> + <simpara> + "month" - mese, testuale, per intero; i.e. "January" + </simpara> + </listitem> + </itemizedlist> + <example> + <title> + Esempio di <function>getdate</function> + </title> + <programlisting role="php"> +<![CDATA[ +$today = getdate(); +$month = $today['month']; +$mday = $today['mday']; +$year = $today['year']; +echo "$month $mday, $year"; +]]> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + + <refentry id="function.gettimeofday"> + <refnamediv> + <refname>gettimeofday</refname> + <refpurpose>Riceve l'orario attuale</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>array</type><methodname>gettimeofday</methodname> + <void/> + </methodsynopsis> + <para> + Questa è un'interfaccia di gettimeofday(2). Restituisce un + array associativo contenente i dati restituiti dalla chiamata al + sistema. + <itemizedlist> + <listitem> + <simpara> + "sec" - secondi + </simpara> + </listitem> + <listitem> + <simpara> + "usec" - microsecondi + </simpara> + </listitem> + <listitem> + <simpara> + "minuteswest" - minuti ovest di Greenwich + </simpara> + </listitem> + <listitem> + <simpara> + "dsttime" - tipo di correzione dell'ora legale + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> + </refentry> + + <refentry id="function.gmdate"> + <refnamediv> + <refname>gmdate</refname> + <refpurpose>Formatta una data/orario GMT/CUT</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>string</type><methodname>gmdate</methodname> + <methodparam><type>string</type><parameter>formato</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam> + </methodsynopsis> + <para> + Identica alla funzione <function>date</function> eccetto per il fatto che + l'orario restituito è del Greenwich Mean Time (GMT). Per esempio, quando + si è in Finlandia (GMT +0200), la prima linea sotto scrive "Jan 01 + 1998 00:00:00", mentre la seconda scrive "Dec 31 1997 22:00:00". + <example> + <title>Esempio di <function>gmdate</function></title> + <programlisting role="php"> +<![CDATA[ +echo date ("M d Y H:i:s", mktime (0,0,0,1,1,1998)); +echo gmdate ("M d Y H:i:s", mktime (0,0,0,1,1,1998)); +]]> + </programlisting> + </example> + </para> + <para> + Guarda anche <function>date</function>, <function>mktime</function>, + <function>gmmktime</function> e <function>strftime</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.gmmktime"> + <refnamediv> + <refname>gmmktime</refname> + <refpurpose>Riceve l'UNIX timestamp per una data GMT</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>int</type><methodname>gmmktime</methodname> + <methodparam><type>int</type><parameter>ora</parameter></methodparam> + <methodparam><type>int</type><parameter>minuto</parameter></methodparam> + <methodparam><type>int</type><parameter>secondo</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> + <methodparam choice="opt"><type>int</type><parameter>is_dst</parameter></methodparam> + </methodsynopsis> + <para> + Identica alla funzione <function>mktime</function> eccetto per il paramentro passato, che + rappresenta una data GMT. + </para> + </refsect1> + </refentry> + + <refentry id="function.gmstrftime"> + <refnamediv> + <refname>gmstrftime</refname> + <refpurpose> + Formatta una data/orario GMT/CUT associandola/o ai parametri locali + </refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>string</type><methodname>gmstrftime</methodname> + <methodparam><type>string</type><parameter>formato</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam> + </methodsynopsis> + <para> + Si comporta allo stesso modo della funzione <function>strftime</function> eccetto che + l'orario restituito è del Greenwich Mean Time (GMT). Ad esempio, quando si è + nell' Eastern Standard Time (GMT -0500), la prima linea sotto scrive + "Dec 31 1998 20:00:00", mentre la seconda scrive "Jan 01 1999 + 01:00:00". + <example> + <title>Esempio di <function>gmstrftime</function></title> + <programlisting role="php"> +<![CDATA[ +setlocale ('LC_TIME', 'en_US'); +echo strftime ("%b %d %Y %H:%M:%S", mktime (20,0,0,12,31,98))."\n"; +echo gmstrftime ("%b %d %Y %H:%M:%S", mktime (20,0,0,12,31,98))."\n"; +]]> + </programlisting> + </example> + </para> + <para> + Guarda anche <function>strftime</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.localtime"> + <refnamediv> + <refname>localtime</refname> + <refpurpose>Riceve l'orario locale</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>array</type><methodname>localtime</methodname> + <methodparam choice="opt"><type>int</type><parameter> + timestamp + </parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter> + is_associative + </parameter></methodparam> + </methodsynopsis> + <para> + La funzione <function>localtime</function> restituisce un array + identico a quello della struttura della chimata della + funzione di C. Il primo argomento per <function>localtime</function> è + il timestamp, se non esiste viene assegnato di default l'orario attuale. + Il secondo argomento di <function>localtime</function> è + <parameter>is_associative</parameter>, se questo è settato a 0 o non + sostituito l'array restituirà un regolare array numerico + indicizzato. Se l'argomento è settato a 1, + <function>localtime</function> è un array associativo contenente + tutti gli elementi differenti della struttura restituita dalla + funzione chiamata localtime di C. Il nome delle differenti chiavi + dell'array associativo sono le seguenti: + <itemizedlist> + <listitem> + <simpara> + "tm_sec" - secondi + </simpara> + </listitem> + <listitem> + <simpara> + "tm_min" - minuti + </simpara> + </listitem> + <listitem> + <simpara> + "tm_hour" - ora + </simpara> + </listitem> + <listitem> + <simpara> + "tm_mday" - giorno del mese + </simpara> + </listitem> + <listitem> + <simpara> + "tm_mon" - mese dell'anno, iniziando con 0 per Gennaio + </simpara> + </listitem> + <listitem> + <simpara> + "tm_year" - Anni dal 1900 + </simpara> + </listitem> + <listitem> + <simpara> + "tm_wday" - Giorno della settimana + </simpara> + </listitem> + <listitem> + <simpara> + "tm_yday" - Giorno dell'anno + </simpara> + </listitem> + <listitem> + <simpara> + "tm_isdst" - Se l'ora legale è effettiva + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> + </refentry> + + <refentry id="function.microtime"> + <refnamediv> + <refname>microtime</refname> + <refpurpose> + Restituisce l'attuale UNIX timestamp con i microsecondi</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>string</type><methodname>microtime</methodname> + <void/> + </methodsynopsis> + <para> + Restituisce la stringa "msec sec" dove sec è l'attuale orario + misurato nel numero di secondi dalla Unix Epoch (0:00:00 + January 1, 1970 GMT), e msec è la parte in microsecondi. Questa funzione + è disponibile solo su sistemi operativi che supportano la + chiamata di sistema gettimeofday(). + </para> + <para> + Entrambi le parti della stringa sono restituite in unità di secondi. + <example> + <title>Esempio di <function>microtime</function></title> + <programlisting role="php"> +<![CDATA[ +function getmicrotime(){ + list($usec, $sec) = explode(" ",microtime()); + return ((float)$usec + (float)$sec); + } + +$time_start = getmicrotime(); + +for ($i=0; $i < 1000; $i++){ + //do nothing, 1000 times + } + +$time_end = getmicrotime(); +$time = $time_end - $time_start; + +echo "Did nothing in $time seconds"; +]]> + </programlisting> + </example> + </para> + <para> + Vedere anche <function>time</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.mktime"> + <refnamediv> + <refname>mktime</refname> + <refpurpose>Restituisce la UNIX timestamp per una data</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>int</type><methodname>mktime</methodname> + <methodparam><type>int</type><parameter>hour</parameter></methodparam> + <methodparam><type>int</type><parameter>minute</parameter></methodparam> + <methodparam><type>int</type><parameter>second</parameter></methodparam> + <methodparam><type>int</type><parameter>month</parameter></methodparam> + <methodparam><type>int</type><parameter>day</parameter></methodparam> + <methodparam><type>int</type><parameter>year</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>is_dst</parameter></methodparam> + </methodsynopsis> + <para> + <emphasis>Attenzione:</emphasis> Nota lo strano ordine degli + argomenti, che differisco dal normale ordine degli argomenti in una normale chiamata + UNIX mktime(). E' un comune errore + la confusione di questi argomenti in uno script. + </para> + <para> + Restituisce la Unix timestamp corrispondente all'argomento + dato. Questa timestamp è un intero lungo contenente il numero di + secondi tra la Unix Epoch (January 1 1970) e la data e orario + specificati. + </para> + <para> + Gli argomenti possono essere omessi nell'ordine da destra a sinistra; degli + argomenti omessi saranno impostati con l'attuale valore accordandolo + alla data e orario locale. + </para> + <para> + <parameter>Is_dst</parameter> può essere impostato su 1 se l'orario è + nell'ora legale, 0 altrimenti, o -1 (di default) + se è sconosciuta la presenza dell'ora legale o + meno. + </para> + <note> + <para> + <parameter>Is_dst</parameter> è stato aggiunto nella verisone 3.0.10. + </para> + </note> + <para> + <function>mktime</function> è usata per fare calcoli tra date + e validazioni, come può calcolare automaticamente il corretto + valore per un valore fuori dall'intervallo valido. Per esempio, ognuna delle seguenti + linee produce la stringa "Jan-01-1998". + <example> + <title>Esempio di <function>mktime</function></title> + <programlisting role="php"> +<![CDATA[ +echo date ("M-d-Y", mktime (0,0,0,12,32,1997)); +echo date ("M-d-Y", mktime (0,0,0,13,1,1997)); +echo date ("M-d-Y", mktime (0,0,0,1,1,1998)); +echo date ("M-d-Y", mktime (0,0,0,1,1,98)); +]]> + </programlisting> + </example> + <parameter>Year</parameter> può avere sia 2 che 4 cifre, + con valori compresi tra 0-69 e 2000-2069 oppure tra 70-99 e + 1970-1999 (sui sistemi dove time_t è un intero segnato a 32bit, come + sulla maggior parte dei PC di oggi, l'intervallo valido per + <parameter>year</parameter> è tra 1902 e 2037). + </para> + <para> + L'ultimo giorno del mese dato può essere espresso come il giorno "0" + del mese successivo, non come il giorno -1. Entrami i seguenti esempi + produrranno la stringa "L'ultimo giorno di Feb 2000 è: 29". + <example> + <title>L'ultimo giorno del mese successivo</title> + <programlisting role="php"> +<![CDATA[ +$lastday = mktime (0,0,0,3,0,2000); +echo strftime ("L'ultimo giorno di Feb 2000 è: %d", $lastday); + +$lastday = mktime (0,0,0,4,-31,2000); +echo strftime ("L'ultimo giorno di Feb 2000 è: %d", $lastday); +]]> + </programlisting> + </example> + </para> + <simpara> + Date con anno, mese e giorno uguali a 0 non sono considerate valide + (altrimenti saranno considerate come 30.11.1999, quando hanno uno strano + behavior). + </simpara> + <para> + Guarda anche <function>date</function> e <function>time</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.strftime"> + <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 locale libreria + di C, in tal caso non sarà supportata dal Php la funzione + <function>strftime</function>. + </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<ulink url="&spec.strftime;"> + specifiche dell' Open Group per + <function>strftime</function></ulink>. + </para> + </refsect1> + </refentry> + + <refentry id="function.time"> + <refnamediv> + <refname>time</refname> + <refpurpose>Restituisce l'attuale UNIX timestamp</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>int</type><methodname>time</methodname> + <void/> + </methodsynopsis> + <para> + Restituisce l'attuale data e orario misurata in numero di secondi dalla + Unix Epoch (January 1 1970 00:00:00 GMT). + </para> + <para> + Guarda anche <function>date</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.strtotime"> + <refnamediv> + <refname>strtotime</refname> + <refpurpose> + Analizza le descrizioni testuali di datetime in Inglese nell'UNIX + timestamp + </refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>int</type><methodname>strtotime</methodname> + <methodparam><type>string</type><parameter>time</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>now</parameter></methodparam> + </methodsynopsis> + <simpara> + La funzione aspetta di avere una stringa contenente un formato di data in + Inglese e proverà a passare questo formato all'UNIX timestamp relativo + al timestamp dato in <parameter>now</parameter>, o l'attuale orario + se non è stato passato il parametro. Sul fallimento, è restituito <literal>-1</literal>. + </simpara> + <simpara> + Perché <function>strtotime</function> si comporti in accordo con la sintassi + della data GNU, dai uno sguardo alla pagina del manuale GNU intitolata + <ulink url="&url.gnu.man.date-input;">Date Input Formats</ulink>. + Descrive se c'è una sinstassi valida per il parametro + <parameter>time</parameter>. + </simpara> + <para> + <example> + <title><function>strtotime</function> - esempi</title> + <programlisting role="php"> +<![CDATA[ +echo strtotime ("now"), "\n"; +echo strtotime ("10 September 2000"), "\n"; +echo strtotime ("+1 day"), "\n"; +echo strtotime ("+1 week"), "\n"; +echo strtotime ("+1 week 2 days 4 hours 2 seconds"), "\n"; +echo strtotime ("next Thursday"), "\n"; +echo strtotime ("last Monday"), "\n"; +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Controllo per il fallimento</title> + <programlisting role="php"> +<![CDATA[ +$str = 'Not Good'; +if (($timestamp = strtotime($str)) === -1) { + echo "The string ($str) is bogus"; +} else { + echo "$str == ". date('l dS of F Y h:i:s A',$timestamp); +} +]]> + </programlisting> + </example> + </para> + <note> + <para> + L'intervallo valido di un timestamp è normalmente da Fri, 13 Dec + 1901 20:45:54 GMT a Tue, 19 Jan 2038 03:14:07 GMT. (Queste sono + le date ce corrispondono al minimo e al massimo valore per + un intero segnato a 32 bit.) + </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: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +-->
Index: phpdoc/it/functions/datetime.xml diff -u /dev/null phpdoc/it/functions/datetime.xml:1.11 --- /dev/null Tue Mar 26 22:11:24 2002 +++ phpdoc/it/functions/datetime.xml Tue Mar 26 22:11:23 2002 @@ -0,0 +1,1170 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.69 Maintainer: curcio_it Status: ready --> + <reference id="ref.datetime"> + <title>Funzioni di Data e Orario</title> + <titleabbrev>Data/orario</titleabbrev> + + <refentry id="function.checkdate"> + <refnamediv> + <refname>checkdate</refname> + <refpurpose>Verifica una data/orario gragoriana/o</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>bool</type><methodname>checkdate</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> + Restituisce &true; se la data inserita è valida; altrimenti restituisce &false;. + Controlla la validità di una data formata dagli argomenti. Una data + è considerata valida se: + <itemizedlist> + <listitem> + <simpara> + anno è compreso tra 1 e 32767 + </simpara> + </listitem> + <listitem> + <simpara> + mese è compreso tra 1 e 12 + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>Giorno</parameter> è compreso tra il numero dei giorni possibile + per il <parameter>mese</parameter> dato. Gli + <parameter>anno</parameter>(i) bisestili sono presi in considerazione. + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + Guarda anche <function>mktime</function> e <function>strtotime</function>. + </para> + </refsect1> + </refentry> + + <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>data</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 del mese, 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 nel 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>data</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> + È possibile usare <function>date()</function> e <function>mktime()</function> + assieme per cercare una data ne 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> + <function>date</function> Formatting + </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> + + <refentry id="function.getdate"> + <refnamediv> + <refname>getdate</refname> + <refpurpose>Riceve informazioni su data/orario</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>array</type><methodname>getdate</methodname> + <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam> + </methodsynopsis> + <para> + Restituisce un array associativo contenente le informazioni sulla data del + <parameter>timestamp</parameter>, o dell'attuale orario locale se + non è stato assegnato timestamp, con i seguenti elementi di + array: + <itemizedlist> + <listitem> + <simpara> + "seconds" - secondi + </simpara> + </listitem> + <listitem> + <simpara> + "minutes" - minuti + </simpara> + </listitem> + <listitem> + <simpara> + "hours" - ore + </simpara> + </listitem> + <listitem> + <simpara> + "mday" - giorno del mese + </simpara> + </listitem> + <listitem> + <simpara> + "wday" - giorno della settimana, numerico : da 0 come Domenica a 6 come Sabato + </simpara> + </listitem> + <listitem> + <simpara> + "mon" - mese, numerico + </simpara> + </listitem> + <listitem> + <simpara> + "year" - anno, numerico + </simpara> + </listitem> + <listitem> + <simpara> + "yday" - giorno dell'anno, numerico; i.e. "299" + </simpara> + </listitem> + <listitem> + <simpara> + "weekday" - giorno della settimana, testuale, per intero; i.e. "Friday" + </simpara> + </listitem> + <listitem> + <simpara> + "month" - mese, testuale, per intero; i.e. "January" + </simpara> + </listitem> + </itemizedlist> + <example> + <title> + Esempio di <function>getdate</function> + </title> + <programlisting role="php"> +<![CDATA[ +$today = getdate(); +$month = $today['month']; +$mday = $today['mday']; +$year = $today['year']; +echo "$month $mday, $year"; +]]> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + + <refentry id="function.gettimeofday"> + <refnamediv> + <refname>gettimeofday</refname> + <refpurpose>Riceve l'orario attuale</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>array</type><methodname>gettimeofday</methodname> + <void/> + </methodsynopsis> + <para> + Questa è un'interfaccia di gettimeofday(2). Restituisce un + array associativo contenente i dati restituiti dalla chiamata al + sistema. + <itemizedlist> + <listitem> + <simpara> + "sec" - secondi + </simpara> + </listitem> + <listitem> + <simpara> + "usec" - microsecondi + </simpara> + </listitem> + <listitem> + <simpara> + "minuteswest" - minuti ovest di Greenwich + </simpara> + </listitem> + <listitem> + <simpara> + "dsttime" - tipo di correzione dell'ora legale + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> + </refentry> + + <refentry id="function.gmdate"> + <refnamediv> + <refname>gmdate</refname> + <refpurpose>Formatta una data/orario GMT/CUT</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>string</type><methodname>gmdate</methodname> + <methodparam><type>string</type><parameter>formato</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam> + </methodsynopsis> + <para> + Identica alla funzione <function>date</function> eccetto per il fatto che + l'orario restituito è del Greenwich Mean Time (GMT). Per esempio, quando + si è in Finlandia (GMT +0200), la prima linea sotto scrive "Jan 01 + 1998 00:00:00", mentre la seconda scrive "Dec 31 1997 22:00:00". + <example> + <title>Esempio di <function>gmdate</function></title> + <programlisting role="php"> +<![CDATA[ +echo date ("M d Y H:i:s", mktime (0,0,0,1,1,1998)); +echo gmdate ("M d Y H:i:s", mktime (0,0,0,1,1,1998)); +]]> + </programlisting> + </example> + </para> + <para> + Guarda anche <function>date</function>, <function>mktime</function>, + <function>gmmktime</function> e <function>strftime</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.gmmktime"> + <refnamediv> + <refname>gmmktime</refname> + <refpurpose>Riceve l'UNIX timestamp per una data GMT</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>int</type><methodname>gmmktime</methodname> + <methodparam><type>int</type><parameter>ora</parameter></methodparam> + <methodparam><type>int</type><parameter>minuto</parameter></methodparam> + <methodparam><type>int</type><parameter>secondo</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> + <methodparam choice="opt"><type>int</type><parameter>is_dst</parameter></methodparam> + </methodsynopsis> + <para> + Identica alla funzione <function>mktime</function> eccetto per il paramentro passato, che + rappresenta una data GMT. + </para> + </refsect1> + </refentry> + + <refentry id="function.gmstrftime"> + <refnamediv> + <refname>gmstrftime</refname> + <refpurpose> + Formatta una data/orario GMT/CUT associandola/o ai parametri locali + </refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>string</type><methodname>gmstrftime</methodname> + <methodparam><type>string</type><parameter>formato</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam> + </methodsynopsis> + <para> + Si comporta allo stesso modo della funzione <function>strftime</function> eccetto che + l'orario restituito è del Greenwich Mean Time (GMT). Ad esempio, quando si è + nell' Eastern Standard Time (GMT -0500), la prima linea sotto scrive + "Dec 31 1998 20:00:00", mentre la seconda scrive "Jan 01 1999 + 01:00:00". + <example> + <title>Esempio di <function>gmstrftime</function></title> + <programlisting role="php"> +<![CDATA[ +setlocale ('LC_TIME', 'en_US'); +echo strftime ("%b %d %Y %H:%M:%S", mktime (20,0,0,12,31,98))."\n"; +echo gmstrftime ("%b %d %Y %H:%M:%S", mktime (20,0,0,12,31,98))."\n"; +]]> + </programlisting> + </example> + </para> + <para> + Guarda anche <function>strftime</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.localtime"> + <refnamediv> + <refname>localtime</refname> + <refpurpose>Riceve l'orario locale</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>array</type><methodname>localtime</methodname> + <methodparam choice="opt"><type>int</type><parameter> + timestamp + </parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter> + is_associative + </parameter></methodparam> + </methodsynopsis> + <para> + La funzione <function>localtime</function> restituisce un array + identico a quello della struttura della chimata della + funzione di C. Il primo argomento per <function>localtime</function> è + il timestamp, se non esiste viene assegnato di default l'orario attuale. + Il secondo argomento di <function>localtime</function> è + <parameter>is_associative</parameter>, se questo è settato a 0 o non + sostituito l'array restituirà un regolare array numerico + indicizzato. Se l'argomento è settato a 1, + <function>localtime</function> è un array associativo contenente + tutti gli elementi differenti della struttura restituita dalla + funzione chiamata localtime di C. Il nome delle differenti chiavi + dell'array associativo sono le seguenti: + <itemizedlist> + <listitem> + <simpara> + "tm_sec" - secondi + </simpara> + </listitem> + <listitem> + <simpara> + "tm_min" - minuti + </simpara> + </listitem> + <listitem> + <simpara> + "tm_hour" - ora + </simpara> + </listitem> + <listitem> + <simpara> + "tm_mday" - giorno del mese + </simpara> + </listitem> + <listitem> + <simpara> + "tm_mon" - mese dell'anno, iniziando con 0 per Gennaio + </simpara> + </listitem> + <listitem> + <simpara> + "tm_year" - Anni dal 1900 + </simpara> + </listitem> + <listitem> + <simpara> + "tm_wday" - Giorno della settimana + </simpara> + </listitem> + <listitem> + <simpara> + "tm_yday" - Giorno dell'anno + </simpara> + </listitem> + <listitem> + <simpara> + "tm_isdst" - Se l'ora legale è effettiva + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> + </refentry> + + <refentry id="function.microtime"> + <refnamediv> + <refname>microtime</refname> + <refpurpose> + Restituisce l'attuale UNIX timestamp con i microsecondi</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>string</type><methodname>microtime</methodname> + <void/> + </methodsynopsis> + <para> + Restituisce la stringa "msec sec" dove sec è l'attuale orario + misurato nel numero di secondi dalla Unix Epoch (0:00:00 + January 1, 1970 GMT), e msec è la parte in microsecondi. Questa funzione + è disponibile solo su sistemi operativi che supportano la + chiamata di sistema gettimeofday(). + </para> + <para> + Entrambi le parti della stringa sono restituite in unità di secondi. + <example> + <title>Esempio di <function>microtime</function></title> + <programlisting role="php"> +<![CDATA[ +function getmicrotime(){ + list($usec, $sec) = explode(" ",microtime()); + return ((float)$usec + (float)$sec); + } + +$time_start = getmicrotime(); + +for ($i=0; $i < 1000; $i++){ + //do nothing, 1000 times + } + +$time_end = getmicrotime(); +$time = $time_end - $time_start; + +echo "Did nothing in $time seconds"; +]]> + </programlisting> + </example> + </para> + <para> + Vedere anche <function>time</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.mktime"> + <refnamediv> + <refname>mktime</refname> + <refpurpose>Restituisce la UNIX timestamp per una data</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>int</type><methodname>mktime</methodname> + <methodparam><type>int</type><parameter>hour</parameter></methodparam> + <methodparam><type>int</type><parameter>minute</parameter></methodparam> + <methodparam><type>int</type><parameter>second</parameter></methodparam> + <methodparam><type>int</type><parameter>month</parameter></methodparam> + <methodparam><type>int</type><parameter>day</parameter></methodparam> + <methodparam><type>int</type><parameter>year</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>is_dst</parameter></methodparam> + </methodsynopsis> + <para> + <emphasis>Attenzione:</emphasis> Nota lo strano ordine degli + argomenti, che differisco dal normale ordine degli argomenti in una normale chiamata + UNIX mktime(). E' un comune errore + la confusione di questi argomenti in uno script. + </para> + <para> + Restituisce la Unix timestamp corrispondente all'argomento + dato. Questa timestamp è un intero lungo contenente il numero di + secondi tra la Unix Epoch (January 1 1970) e la data e orario + specificati. + </para> + <para> + Gli argomenti possono essere omessi nell'ordine da destra a sinistra; degli + argomenti omessi saranno impostati con l'attuale valore accordandolo + alla data e orario locale. + </para> + <para> + <parameter>Is_dst</parameter> può essere impostato su 1 se l'orario è + nell'ora legale, 0 altrimenti, o -1 (di default) + se è sconosciuta la presenza dell'ora legale o + meno. + </para> + <note> + <para> + <parameter>Is_dst</parameter> è stato aggiunto nella verisone 3.0.10. + </para> + </note> + <para> + <function>mktime</function> è usata per fare calcoli tra date + e validazioni, come può calcolare automaticamente il corretto + valore per un valore fuori dall'intervallo valido. Per esempio, ognuna delle seguenti + linee produce la stringa "Jan-01-1998". + <example> + <title>Esempio di <function>mktime</function></title> + <programlisting role="php"> +<![CDATA[ +echo date ("M-d-Y", mktime (0,0,0,12,32,1997)); +echo date ("M-d-Y", mktime (0,0,0,13,1,1997)); +echo date ("M-d-Y", mktime (0,0,0,1,1,1998)); +echo date ("M-d-Y", mktime (0,0,0,1,1,98)); +]]> + </programlisting> + </example> + <parameter>Year</parameter> può avere sia 2 che 4 cifre, + con valori compresi tra 0-69 e 2000-2069 oppure tra 70-99 e + 1970-1999 (sui sistemi dove time_t è un intero segnato a 32bit, come + sulla maggior parte dei PC di oggi, l'intervallo valido per + <parameter>year</parameter> è tra 1902 e 2037). + </para> + <para> + L'ultimo giorno del mese dato può essere espresso come il giorno "0" + del mese successivo, non come il giorno -1. Entrami i seguenti esempi + produrranno la stringa "L'ultimo giorno di Feb 2000 è: 29". + <example> + <title>L'ultimo giorno del mese successivo</title> + <programlisting role="php"> +<![CDATA[ +$lastday = mktime (0,0,0,3,0,2000); +echo strftime ("L'ultimo giorno di Feb 2000 è: %d", $lastday); + +$lastday = mktime (0,0,0,4,-31,2000); +echo strftime ("L'ultimo giorno di Feb 2000 è: %d", $lastday); +]]> + </programlisting> + </example> + </para> + <simpara> + Date con anno, mese e giorno uguali a 0 non sono considerate valide + (altrimenti saranno considerate come 30.11.1999, quando hanno uno strano + behavior). + </simpara> + <para> + Guarda anche <function>date</function> e <function>time</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.strftime"> + <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 locale libreria + di C, in tal caso non sarà supportata dal Php la funzione + <function>strftime</function>. + </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<ulink url="&spec.strftime;"> + specifiche dell' Open Group per + <function>strftime</function></ulink>. + </para> + </refsect1> + </refentry> + + <refentry id="function.time"> + <refnamediv> + <refname>time</refname> + <refpurpose>Restituisce l'attuale UNIX timestamp</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>int</type><methodname>time</methodname> + <void/> + </methodsynopsis> + <para> + Restituisce l'attuale data e orario misurata in numero di secondi dalla + Unix Epoch (January 1 1970 00:00:00 GMT). + </para> + <para> + Guarda anche <function>date</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.strtotime"> + <refnamediv> + <refname>strtotime</refname> + <refpurpose> + Analizza le descrizioni testuali di datetime in Inglese nell'UNIX + timestamp + </refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <methodsynopsis> + <type>int</type><methodname>strtotime</methodname> + <methodparam><type>string</type><parameter>time</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>now</parameter></methodparam> + </methodsynopsis> + <simpara> + La funzione aspetta di avere una stringa contenente un formato di data in + Inglese e proverà a passare questo formato all'UNIX timestamp relativo + al timestamp dato in <parameter>now</parameter>, o l'attuale orario + se non è stato passato il parametro. Sul fallimento, è restituito <literal>-1</literal>. + </simpara> + <simpara> + Perché <function>strtotime</function> si comporti in accordo con la sintassi + della data GNU, dai uno sguardo alla pagina del manuale GNU intitolata + <ulink url="&url.gnu.man.date-input;">Date Input Formats</ulink>. + Descrive se c'è una sinstassi valida per il parametro + <parameter>time</parameter>. + </simpara> + <para> + <example> + <title><function>strtotime</function> - esempi</title> + <programlisting role="php"> +<![CDATA[ +echo strtotime ("now"), "\n"; +echo strtotime ("10 September 2000"), "\n"; +echo strtotime ("+1 day"), "\n"; +echo strtotime ("+1 week"), "\n"; +echo strtotime ("+1 week 2 days 4 hours 2 seconds"), "\n"; +echo strtotime ("next Thursday"), "\n"; +echo strtotime ("last Monday"), "\n"; +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Controllo per il fallimento</title> + <programlisting role="php"> +<![CDATA[ +$str = 'Not Good'; +if (($timestamp = strtotime($str)) === -1) { + echo "The string ($str) is bogus"; +} else { + echo "$str == ". date('l dS of F Y h:i:s A',$timestamp); +} +]]> + </programlisting> + </example> + </para> + <note> + <para> + L'intervallo valido di un timestamp è normalmente da Fri, 13 Dec + 1901 20:45:54 GMT a Tue, 19 Jan 2038 03:14:07 GMT. (Queste sono + le date ce corrispondono al minimo e al massimo valore per + un intero segnato a 32 bit.) + </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: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +-->