DATE STOD()

From Recital Documentation Wiki
Revision as of 10:59, 30 March 2009 by Yvonnemilne (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

PURPOSE

Return a character string as a date


SYNONYM

api_date_stod()


SYNOPSIS

#include "dbapi.h"
 
unsigned long	DATE_STOD(string)
 
<input parameters>
char	string;		/* Address of a buffer containing character string	*/
 
<output parameters>
none


DESCRIPTION

The DATE_STOD() function will return will return the specified string in the format "YYYYMMDD" as an unsigned long, the Recital date format. This function can be used to convert data values for updating Recital date memory variables.


EXAMPLE

The following example converts today's date specified in the character pointer date to an unsigned long.

#include "dbapi.h"
 
dbapi_date_stod()
{
    int		month;
    unsigned long	date;
 
    if (_parinfo(1) != API_DTYPE) {
       _retc("");
    }
 
    date = DATE_STOD(_pards(1) );
    day = DATE_DAY( date );
 
    if ( month ==  12) {
       /* commands	*/
    }
 
}


SEE ALSO

_parc(), _parclen(), _parcsiz(), _parinfo(), _retc(), _retclen(), ISCHAR(), CHAR_ALLTRIM(), CHAR_LOWER(), CHAR_LPAD(), CHAR_LTRIM(), CHAR_RPAD(), CHAR_RTRIM(), CHAR_STR(), CHAR_UPPER(), DATE_AMPM(), DATE_CDOW(), DATE_CMONTH(), DATE_CTOD(), DATE_DATE(), DATE_DAY(), DATE_DOW(), DATE_DTOC(), DATE_DTOS(), DATE_TIME(), DATE_YEAR()