Difference between revisions of "DATE STOD()"

From Recital Documentation Wiki
Jump to: navigation, search
 
 
Line 52: Line 52:
  
 
==SEE ALSO==
 
==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_STOD()]], [[DATE_TIME()]], [[DATE_YEAR()]]
+
[[_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()]]
  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:SDK]]
 
[[Category:SDK]]

Latest revision as of 10:59, 30 March 2009

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()