<!-- 

     This document is part of the Geodetic Data Manipulation System
     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="cepDate">
<refmeta>
<refentrytitle>cepDate</refentrytitle>
<manvolnum>3</manvolnum>
</refmeta>

<refnamediv>
<refname>cepDate</refname>
<refpurpose>Converts a decimal date in the format of YYYY.DDDD, where YYYY is a four</refpurpose>
</refnamediv>

<refsynopsisdiv>
<synopsis>
 To create a cepDate object to convert a decimal date to a Gregorian date use:-
 
 cepDate date(value);
 
 &lt;para&gt;&lt;itemizedlist&gt;
 &lt;listitem&gt;&lt;para&gt;value:- The decimal value to be converted. It must be of the form
 YYYY.DDDD where YYYY is the four digit year and DDDD is the decimal represenation
 of the number of days into the year&lt;/para&gt;&lt;/listitem&gt;
 &lt;/itemizedlist&gt;&lt;/para&gt;
 
 To create a cepDate object to convert a Gregorian date to a decimal date use:-
 
 cepDate date(day, month, year);
 
 &lt;para&gt;&lt;itemizedlist&gt;
 &lt;listitem&gt;&lt;para&gt;day:- interger value of the day of the month from 1..31&lt;/para&gt;&lt;/listitem&gt;
 &lt;listitem&gt;&lt;para&gt;month:- the name of the month. This can be either Jan...Dec or
 January...December&lt;/para&gt;&lt;/listitem&gt;
 &lt;listitem&gt;&lt;para&gt;year:- interger value of the year&lt;/para&gt;&lt;/listitem&gt;
 &lt;/itemizedlist&gt;&lt;/para&gt;
 
 &lt;/para&gt;
 
 

</synopsis>
</refsynopsisdiv>

<refsect1>
<title>DESCRIPTION</title>
<para> An implementation of the &lt;command&gt;cepDate&lt;/command&gt; class
 converts a decimal date to a Gegorian date or a Gregorian date to a decimal.
 &lt;/para&gt;
 
 &lt;para&gt;
 &lt;command&gt;const string getDay()&lt;/command&gt;
 returns day of month in the format of 01...31. A return value of -1 indicates
 an error because the date entered was invalid.
 &lt;/para&gt;
 
 &lt;para&gt;
 &lt;command&gt;const string getMonth()&lt;/command&gt;
 returns month in the format of 01...12. A return value of -1 indicates
 an error because the date entered was invalid.
 &lt;/para&gt;
 
 &lt;para&gt;
 &lt;command&gt;const string getMonthName()&lt;/command&gt;
 returns month as a string in the format of January...December
 &lt;/para&gt;
 
 &lt;para&gt;
 &lt;command&gt;const string getShortMonthName()&lt;/command&gt;
 returns month as a string in the format of Jan...Dec
 &lt;/para&gt;
 
 &lt;para&gt;
 &lt;command&gt;const string getYear()&lt;/command&gt;
 returns year in the format of YYYY. A return value of -1 indicates
 an error because the date entered was invalid.
 &lt;/para&gt;
 
 &lt;para&gt;
 &lt;command&gt;const string getShortDate()&lt;/command&gt;
 returns date in short date in the format of DD/MM/YY
 &lt;/para&gt;
 
 &lt;para&gt;
 &lt;command&gt;const string getLongDate()&lt;/command&gt;
 returns date in long date date in the format of DD MMMMMM YY
 &lt;/para&gt;
 
 &lt;para&gt;
 &lt;command&gt;const string getDecimalDate()&lt;/command&gt;
 returns the date as a decimal date in the form YYYY.DDDD. A return value of -1 indicates
 an error because the date entered was invalid.
 &lt;/para&gt;
 
 &lt;para&gt;
 2 new methods added yearsToJulian and julianToYears. Both take and return doubles
 and have no relation to the member variables of this object.
 &lt;/para&gt;
 
</para>
</refsect1>


<refsect1>
    <title>VERSION</title>
    <para>
This documentation was generated for the <command>Geodetic Data Manipulation System</command> 0.1 by <command>autodocbook</command> (http://www.stillhq.com).
    </para>
</refsect1>

<refsect1>
    <title>AUTHOR</title>
    <para>
The <command>Geodetic Data Manipulation System</command> is under development by Michael Still (mikal@stillhq.com), Daniel Fernandez, Kristy Van Der Vlist, Blake Swadling, and Nick Wheatstone. All code is Copyright 2002 Michael Still, Daniel Fernandez, Kristy Van Der Vlist, Blake Swadling and Nick Wheatstone,  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 the <command>Geodetic Data Manipulation System</command>. If you find one, please contact mikal@stillhq.com and let me know.
</para>
</refsect1>
</refentry>
