DATETOA C-3

NAME

datetoa - convert DATE to ASCII

SYNOPSIS

#include char *datetoa (d) DATE d;

DESCRIPTION

Datetoa converts the DATE value d to its ASCII string representation and returns a pointer to that string. The format returned by getfdate(C-3) provides the format to convert the DATE value. The DATE value parameter represents the number of days beginning with January 1, 1800. January 1, 1800 has a DATE value of 1. If the date is in the twentieth century, a two digit string replaces yy in the format. Otherwise, a four digit string always replaces yy or yyyy in the format.

SEE ALSO

getfdate(C-3), fdatetoa(C-3), atodate(C-3) C/Base Reference Manual Chapter 13, "Formatting Data Values" DIAGNOSTICS If the parameter d is less than or equal to zero, or if the system format string is invalid, a pointer to an empty string is returned.

 

NOTES

The return value points to static data whose contents are overwritten with every call.