DATE YEAR()

From Recital Documentation Wiki
Jump to: navigation, search

PURPOSE

Return the year from a date


SYNONYM

api_date_year()


SYNOPSIS

#include "dbapi.h"
 
int	DATE_YEAR(date)
 
<input parameters>
unsigned long	date;		/* Recital date		*/
 
<output parameters>
none


DESCRIPTION

The DATE_YEAR() function will return will return the numeric year value from the specified date as an integer.


EXAMPLE

The following example converts today's date to an integer value representing the year.

#include "dbapi.h"
 
dbapi_date_year()
{
    int		year;
    unsigned long	date;
 
    if (_parinfo(1) != API_DTYPE) {;
       _retc("");
    }
 
    date = DATE_STOD(_pards(1));
    year = DATE_YEAR( date );
 
    if (year ==1992) {
       /* commands	*/
    }
 
}


SEE ALSO

_parinfa(), _parinfo(), _pards(), _retds(), ISDATE(), DATE_AMPM(), DATE_CDOW(), DATE_CMONTH(), DATE_CTOD(), DATE_DATE(), DATE_DAY(), DATE_DOW(), DATE_DTOC(), DATE_DTOS(), DATE_MONTH(), DATE_STOD(), DATE_TIME()