Documentation

The Time argument is converted to a UTC date and time string and stored in 'str'. The optional format string describes how the string is to be converted. The format contains arbitrary characters interspesed with escaped format specifiers that cause the appropriate date information to be inserted. Each escaped format specifier is of the form "%[0][n]<fmt>". If a leading "0" is specified, numeric fields are padded with zeroes if necessary. If a numeric field width is specified, the field is padded on the left with blanks or truncated as appropriate to give the correct field length. The following table lists the format codes and their meaning:

Format	Meaning	Format	Meaning	Format	Meaning
%d	Day of month	%D	Day of year	%H	Hour of day
%m	Month number	%M	Month name	%n	Nanoseconds
%N	Minute in hour	%S	seconds	%s	GPS seconds
%w	Week day	%y	Year in century	%Y	Year
%Z	Time zone

For example, a format like fmt="Today's date is %02d %3M %Y" would produce a string like "Today's date is 09 Dec 2003". If no format is specified, "%s:%n" is used.

Returns:

Returns the output string pointer or Null upon failure.

Parameters:

t - Time to be converted
str - Character array into which the string will be stored.
format - Format string.