TIMETOA C-3

NAME

timetoa - convert TIME value to ASCII equivalent

SYNOPSIS

#include <cbase/dtypes.h>

char *timetoa (t)

TIME t;

DESCRIPTION

The function timetoa converts a valid TIME value into an ASCII string, and returns a pointer to the string. The format returned by getftime(C-3) provides the format to convert the TIME value.

The TIME value parameter represents the number of seconds from midnight. Midnight has a TIME value of 1.

SEE ALSO

getftime(C-3), ftimetoa(C-3), atottime(C-3)

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

DIAGNOSTICS

If the TIME value t is invalid or if the format is invalid, a pointer to an empty string is returned.

NOTES

The return value points to static data whose contents are overwritten by each call.