Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The dtextend() function extends a datetime value to a different qualifier. Extending is the operation of adding or dropping fields of a DATETIME value to make it match a given qualifier.

mint dtextend(in_dt, out_dt)

	dtime_t *in_dt, *out_dt;

 



in_dt

is a pointer to the datetime variable to extend. 


out_dt  

is a pointer to the datetime variable with a valid qualifier to use for the extension. 

The dtextend() function copies the qualifier-field digits of the in_dt datetime variable to the out_dt datetime variable. The qualifier of the out_dt variable controls the copy.

The function discards any fields in in_dt that the out_dt variable does not include. The function fills in any fields in out_dt that are not present in in_dt, as follows:

• It fills in fields to the left of the most-significant field in in_dt from the current time and date.
• It fills in fields to the right of the least-significant field in in_dt with zeros.

In the following example, a variable fiscal_start is set up with the first day of a fiscal year that begins on June 1. The dtextend() function generates the current year.

    datetime  work,  fiscal_start;



work.dt_qual  =  TU_DTENCODE(TU_MONTH,TU_DAY);

dtcvasc("06-01",&work);

fiscal_start.dt_qual  =  TU_DTENCODE(TU_YEAR,TU_DAY);

dtextend(&work,&fiscal_start);