mktime.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- splitted from ./it/functions/datetime.xml, last change in rev 1.1 -->
<!-- last change to 'mktime' 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.mktime" xmlns="http://docbook.org/ns/docbook">
   <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 differiscono dal normale ordine degli argomenti in una normale chiamata
     UNIX mktime() e che non si presta bene a far
     comparire i parametri da destra a sinistra (guarda sotto). 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. Se è sconosciuto, il PHP proverà ad impostarlo da se. Questo può
     causare un risultato non aspettato (ma non sbagliato).
    </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>

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