FDATETOA C-3





Copyright (C) 1994-95 Conetic Software Systems, Inc. All names, products, and services mentioned are the trademarks of their respective organizations.



NAME


fdatetoa - format DATE to ASCII

SYNOPSIS


#include 

int fdatetoa (d, format, dest, len)
DATE d;
char *format;
char *dest;
int len;

DESCRIPTION


Fdatetoa converts the DATE value d  to its ASCII string
representation with format, storing the result in dest: a string
of len bytes. The number of bytes used in the formatted result is
returned.

The DATE value parameter is 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 is used to replace yy in format. 
Otherwise, a four digit string replaces yy or yyyy.

SEE ALSO


getfdate(C-3), datetoa(C-3)
C/Base Reference Manual  Chapter 13,  "Formatting Data Values"

DIAGNOSTICS

If an error occurs, fdatetoa returns a negative number and the
contents of dest are undefined. The following symbolic error
codes are defined in :

          FTOOBIG   the formatted result is longer than the
                    destination length, len
     
          FFORMAT   format is empty or contains invalid key
                    letters

          FEDIT     d is not a valid date value