<!-- 

     This document is part of the panda distribution, and is covered
     by the GNU GPL, a copy of which is in the file named COPYING inside the
     distribution.

     This program and it's documentation are distributed in the hope that 
     they will be useful,but WITHOUT ANY WARRANTY; without even the implied 
     warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     GNU General Public License for more details.
-->

<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">

<refentry id="panda_makedate">
<refmeta>
<refentrytitle>panda_makedate</refentrytitle>
<manvolnum>3</manvolnum>
</refmeta>

<refnamediv>
<refname>panda_makedate</refname>
<refpurpose>format a date into the internal PDF representation</refpurpose>
</refnamediv>

<refsynopsisdiv>
<synopsis>
 #include&amp;lt;panda/constants.h&amp;gt;
 #include&amp;lt;panda/functions.h&amp;gt;
 void panda_makedate (int year, int month, int day, int hour, int minutes, int seconds);

</synopsis>
</refsynopsisdiv>

<refsect1>
<title>DESCRIPTION</title>
<para>&lt;command&gt;PANDA INTERNAL&lt;/command&gt;. The function makedate generates a date that is suitable to be embedded into a PDF. This date will include information about the timezone in which the PDF was created and the relationship that this timezone has with GMT (Zulu) time. Mostly this function is used internally within Panda, and should not concern the average programmer too much.</para>
</refsect1>

<refsect1>
<title>RETURNS</title>
<para>The date passed formatted as a null terminated string.</para>
</refsect1>

<refsect1>
<title>EXAMPLE</title>
<programlisting>
 #include&amp;lt;panda/constants.h&amp;gt;
 #include&amp;lt;panda/functions.h&amp;gt;
 printf("Panda would encode 19 July 1977 3:14:23 AM as: %s\n",
 panda_makedate(1977, 7, 19, 3, 14, 23));
</programlisting>
</refsect1>

<refsect1>
<title>SEE ALSO</title>
<para>panda_nowdate</para>
</refsect1>


<refsect1>
    <title>VERSION</title>
    <para>
This documentation was generated for <command>Panda</command> 0.5.2 by <command>autodocbook</command> (http://www.stillhq.com).
    </para>
</refsect1>

<refsect1>
    <title>AUTHOR</title>
    <para>
<command>Panda</command> is under development by Michael Still (mikal@stillhq.com). All code is Copyright Michael Still 2000 - 2003,  and is released under the GNU GPL. Code submissions are welcomed. Contact Michael at the address above if you have something you would like to contribute.
</para>
</refsect1>

<refsect1>
    <title>BUGS</title>
    <para>
There  are no known bugs in <command>Panda</command>. If you find one, please contact mikal@stillhq.com and let me know.
</para>
</refsect1>
</refentry>
