INFORMIX-ESQL/C Programmer's Manual ESQL/C Function Library

The rfmtdate() function uses a formatting mask to convert an internal DATE format to a character string.

mint rfmtdate(jdate, fmtstring, outbuf)

	int4 jdate;

	char *fmtstring;

	char *outbuf;

 



jdate

is the internal representation of a date to convert.


fmtstring  

is a pointer to the buffer that contains the formatting mask to use the jdate value. 


outbuf

is a pointer to the buffer that receives the formatted string for the jdate value. 

The fmtstring argument of the rfmtdate() function points to the date-formatting mask, which contains formats that describe how to format the date string. For more information on these date formats, see Formatting Numeric Strings.

The examples in the following table use the formatting mask in fmtstring to convert the integer jdate, whose value corresponds to December 25, 1995, to a formatted string outbuf. You must specify one or more fields.

When you use a nondefault locale whose dates contain eras, you can use extended-format strings in the fmtstring argument of rfmtdate(). For more information, see the Informix Guide to GLS Functionality.

The demo directory contains this sample program in the rfmtdate.ec file.

/*
* rfmtdate.ec *

The following program converts a date from internal format to
a specified format using rfmtdate().
*/

#include <stdio.h>

main()
{
char the_date[15];
int4 i_date;
mint x;
int errnum;
static short mdy_array[3] = { 12, 10, 1994 };

printf("RFMTDATE Sample ESQL Program running.\n\n");

if ((errnum = rmdyjul(mdy_array, &i_date)) == 0)
{

/*
* Convert date to "mm-dd-yyyy" format
*/
if (x = rfmtdate(i_date, "mm-dd-yyyy", the_date))
printf("First rfmtdate() call failed with error %d\n", x);
else
printf("\tConverted date (mm-dd-yyy): %s\n", the_date);

/*
* Convert date to "mm.dd.yy" format
*/
if (x = rfmtdate(i_date, "mm.dd.yy", the_date))
printf("Second rfmtdate() call failed with error %d\n",x);
else
printf("\tConverted date (mm.dd.yy): %s\n", the_date);

/*
* Convert date to "mmm ddth, yyyy" format
*/
if (x = rfmtdate(i_date, "mmm ddth, yyyy", the_date))
printf("Third rfmtdate() call failed with error %d\n", x);
else
printf("\tConverted date (mmm ddth, yyyy): %s\n", the_date);
}

printf("\nRFMTDATE Sample Program over.\n\n");
}

RFMTDATE Sample ESQL Program running.



	Converted date (mm-dd-yyy): 12-10-1994.

	Converted date (mm.dd.yy): 12.10.94.

	Converted date (mmm ddth, yyyy): Dec 10th, 1994



RFMTDATE Sample Program over.