/*
 * $Id$
 */

/*
 * The following parts are Copyright of the individual authors.
 * www - http://harbour-project.org
 *
 * Copyright 1999-2001 Viktor Szakats (harbour syenar.net)
 *   Header file for the API
 *
 * See COPYING for licensing terms.
 *
 */

/*  $DOC$
 *  $TEMPLATE$
 *      Function
 *  $NAME$
 *      hb_dateSeconds()
 *  $CATEGORY$
 *      C level API
 *  $SUBCATEGORY$
 *      Date/Time
 *  $ONELINER$
 *
 *  $SYNTAX$
 *      C Prototype
 *
 *      #include "hbdate.h"
 *      hb_dateSeconds( void ) --> ( double )dResult
 *  $ARGUMENTS$
 *
 *  $RETURNS$
 *      <dResult>
 *  $DESCRIPTION$
 *
 *  $EXAMPLES$
 *
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *      NA
 *  $FILES$
 *      Library is rtl
 *  $PLATFORMS$
 *      All
 *  $SEEALSO$
 *
 *  $END$
 */

/*  $DOC$
 *  $TEMPLATE$
 *      Procedure
 *  $NAME$
 *      hb_dateToday()
 *  $CATEGORY$
 *      C level API
 *  $SUBCATEGORY$
 *      Date/Time
 *  $ONELINER$
 *
 *  $SYNTAX$
 *      C Prototype
 *
 *      #include "hbdate.h"
 *      hb_dateToday( long * plYear, long * plMonth, long * plDay )
 *  $ARGUMENTS$
 *      <plYear>
 *
 *      <plMonth>
 *
 *      <plDay>
 *  $DESCRIPTION$
 *
 *  $EXAMPLES$
 *
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *      NA
 *  $FILES$
 *      Library is rtl
 *  $PLATFORMS$
 *      All
 *  $SEEALSO$
 *
 *  $END$
 */

/*  $DOC$
 *  $TEMPLATE$
 *      Procedure
 *  $NAME$
 *      hb_dateTimeStr()
 *  $CATEGORY$
 *      C level API
 *  $SUBCATEGORY$
 *      Date/Time
 *  $ONELINER$
 *      Get the current workstation time
 *  $SYNTAX$
 *      C Prototype
 *
 *      #include "hbdate.h"
 *      hb_dateTimeStr( char * pszTime )
 *  $ARGUMENTS$
 *      <pszTime>
 *  $DESCRIPTION$
 *      The current workstation time is stored into the buffer pointed
 *      to by pszTime.  This buffer must be at least nine characters long.
 *  $EXAMPLES$
 *
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *      NA
 *  $FILES$
 *      Library is rtl
 *  $PLATFORMS$
 *      All
 *  $SEEALSO$
 *
 *  $END$
 */

/*  $DOC$
 *  $TEMPLATE$
 *      Function
 *  $NAME$
 *      hb_dateCMonth()
 *  $CATEGORY$
 *      C level API
 *  $SUBCATEGORY$
 *      Date/Time
 *  $ONELINER$
 *
 *  $SYNTAX$
 *      C Prototype
 *
 *      #include "hbdate.h"
 *      hb_dateCMonth( int iMonth ) --> ( char * )pszResult
 *  $ARGUMENTS$
 *      <iMonth>
 *  $RETURNS$
 *      <pszResult>
 *  $DESCRIPTION$
 *
 *  $EXAMPLES$
 *
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *      NA
 *  $FILES$
 *      Library is rtl
 *  $PLATFORMS$
 *      All
 *  $SEEALSO$
 *
 *  $END$
 */

/*  $DOC$
 *  $TEMPLATE$
 *      Function
 *  $NAME$
 *      hb_dateCDOW()
 *  $CATEGORY$
 *      C level API
 *  $SUBCATEGORY$
 *      Date/Time
 *  $ONELINER$
 *
 *  $SYNTAX$
 *      C Prototype
 *
 *      #include "hbdate.h"
 *      hb_dateCDOW( int iDay ) --> ( char * )pszResult
 *  $ARGUMENTS$
 *      <iDay>
 *  $RETURNS$
 *      <pszResult>
 *  $DESCRIPTION$
 *
 *  $EXAMPLES$
 *
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *      NA
 *  $FILES$
 *      Library is rtl
 *  $PLATFORMS$
 *      All
 *  $SEEALSO$
 *
 *  $END$
 */

/*  $DOC$
 *  $TEMPLATE$
 *      Function
 *  $NAME$
 *      hb_dateDOW()
 *  $CATEGORY$
 *      C level API
 *  $SUBCATEGORY$
 *      Date/Time
 *  $ONELINER$
 *
 *  $SYNTAX$
 *      C Prototype
 *
 *      #include "hbdate.h"
 *      hb_dateDOW( long lYear, long lMonth, long lDay ) --> ( long )lResult
 *  $ARGUMENTS$
 *      <lYear>
 *
 *      <lMonth>
 *
 *      <lDay>
 *  $RETURNS$
 *      <lResult>
 *  $DESCRIPTION$
 *
 *  $EXAMPLES$
 *
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *      NA
 *  $FILES$
 *      Library is rtl
 *  $PLATFORMS$
 *      All
 *  $SEEALSO$
 *
 *  $END$
 */

/*  $DOC$
 *  $TEMPLATE$
 *      Function
 *  $NAME$
 *      hb_dateFormat()
 *  $CATEGORY$
 *      C level API
 *  $SUBCATEGORY$
 *      Date/Time
 *  $ONELINER$
 *
 *  $SYNTAX$
 *      C Prototype
 *
 *      #include "hbdate.h"
 *      hb_dateFormat( const char * szDate, char * szFormattedDate, const char * szDateFormat ) --> ( char * )pszResult
 *  $ARGUMENTS$
 *      <szDate>
 *
 *      <szFormattedDate>
 *
 *      <szDateFormat>
 *  $RETURNS$
 *      <pszResult>
 *  $DESCRIPTION$
 *
 *  $EXAMPLES$
 *
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *      NA
 *  $FILES$
 *      Library is rtl
 *  $PLATFORMS$
 *      All
 *  $SEEALSO$
 *
 *  $END$
 */

/*  $DOC$
 *  $TEMPLATE$
 *      Function
 *  $NAME$
 *      hb_dateEncode()
 *  $CATEGORY$
 *      C level API
 *  $SUBCATEGORY$
 *      Date/Time
 *  $ONELINER$
 *
 *  $SYNTAX$
 *      C Prototype
 *
 *      #include "hbdate.h"
 *      hb_dateEncode( long lYear, long lMonth, long lDay ) --> ( long )lResult
 *  $ARGUMENTS$
 *      <lYear>
 *
 *      <lMonth>
 *
 *      <lDay>
 *  $RETURNS$
 *      <lResult>
 *  $DESCRIPTION$
 *
 *  $EXAMPLES$
 *
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *      NA
 *  $FILES$
 *      Library is rtl
 *  $PLATFORMS$
 *      All
 *  $SEEALSO$
 *
 *  $END$
 */

/*  $DOC$
 *  $TEMPLATE$
 *      Procedure
 *  $NAME$
 *      hb_dateDecode()
 *  $CATEGORY$
 *      C level API
 *  $SUBCATEGORY$
 *      Date/Time
 *  $ONELINER$
 *
 *  $SYNTAX$
 *      C Prototype
 *
 *      #include "hbdate.h"
 *      hb_dateDecode( long julian, long * plYear, long * plMonth, long * plDay )
 *  $ARGUMENTS$
 *      <julian>
 *
 *      <plYear>
 *
 *      <plMonth>
 *
 *      <plDay>
 *  $DESCRIPTION$
 *
 *  $EXAMPLES$
 *
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *      NA
 *  $FILES$
 *      Library is rtl
 *  $PLATFORMS$
 *      All
 *  $SEEALSO$
 *
 *  $END$
 */

/*  $DOC$
 *  $TEMPLATE$
 *      Procedure
 *  $NAME$
 *      hb_dateStrPut()
 *  $CATEGORY$
 *      C level API
 *  $SUBCATEGORY$
 *      Date/Time
 *  $ONELINER$
 *
 *  $SYNTAX$
 *      C Prototype
 *
 *      #include "hbdate.h"
 *      hb_dateStrPut( char * szDate, long lYear, long lMonth, long lDay )
 *  $ARGUMENTS$
 *      <szDate>
 *
 *      <lYear>
 *
 *      <lMonth>
 *
 *      <lDay>
 *  $DESCRIPTION$
 *
 *  $EXAMPLES$
 *
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *      NA
 *  $FILES$
 *      Library is rtl
 *  $PLATFORMS$
 *      All
 *  $SEEALSO$
 *
 *  $END$
 */

/*  $DOC$
 *  $TEMPLATE$
 *      Procedure
 *  $NAME$
 *      hb_dateStrGet()
 *  $CATEGORY$
 *      C level API
 *  $SUBCATEGORY$
 *      Date/Time
 *  $ONELINER$
 *
 *  $SYNTAX$
 *      C Prototype
 *
 *      #include "hbdate.h"
 *      hb_dateStrGet( const char * szDate, long * plYear, long * plMonth, long * plDay )
 *  $ARGUMENTS$
 *      <szDate>
 *
 *      <plYear>
 *
 *      <plMonth>
 *
 *      <plDay>
 *  $DESCRIPTION$
 *
 *  $EXAMPLES$
 *
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *      NA
 *  $FILES$
 *      Library is rtl
 *  $PLATFORMS$
 *      All
 *  $SEEALSO$
 *
 *  $END$
 */

/*  $DOC$
 *  $TEMPLATE$
 *      Function
 *  $NAME$
 *      hb_dateDecStr()
 *  $CATEGORY$
 *      C level API
 *  $SUBCATEGORY$
 *      Date/Time
 *  $ONELINER$
 *
 *  $SYNTAX$
 *      C Prototype
 *
 *      #include "hbdate.h"
 *      hb_dateDecStr( char * szDate, long lJulian ) --> ( char * )pszResult
 *  $ARGUMENTS$
 *      <szDate>
 *
 *      <lJulian>
 *  $RETURNS$
 *      <pszResult>
 *  $DESCRIPTION$
 *
 *  $EXAMPLES$
 *
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *      NA
 *  $FILES$
 *      Library is rtl
 *  $PLATFORMS$
 *      All
 *  $SEEALSO$
 *
 *  $END$
 */

/*  $DOC$
 *  $TEMPLATE$
 *      Function
 *  $NAME$
 *      hb_dateEncStr()
 *  $CATEGORY$
 *      C level API
 *  $SUBCATEGORY$
 *      Date/Time
 *  $ONELINER$
 *
 *  $SYNTAX$
 *      C Prototype
 *
 *      #include "hbdate.h"
 *      hb_dateEncStr( char * szDate ) --> ( long ) lResult
 *  $ARGUMENTS$
 *      <szDate>
 *  $RETURNS$
 *      <lResult>
 *  $DESCRIPTION$
 *
 *  $EXAMPLES$
 *
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *      NA
 *  $FILES$
 *      Library is rtl
 *  $PLATFORMS$
 *      All
 *  $SEEALSO$
 *
 *  $END$
 */