DATETOA C-3

NAME

datetoa - convert DATE to ASCII

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.

getfdate(C-3), fdatetoa(C-3), atodate(C-3)

C/Base Reference Manual Chapter 13, "Formatting Data Values"

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.

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