Time_ToAscii — C Library Procedures

NAME

Time_ToAscii, Time_FromAscii, Time_ToParts, Time_FromParts − time conversion routines

SYNOPSIS

#include <spriteTime.h>
Time_ToAscii(seconds, isInterval, bufferPtr)
Time_FromAscii(bufferPtr, timePtr)
Time_ToParts(seconds, isInterval, partsPtr)
Time_FromParts(partsPtr, isInterval, secondsPtr)

ARGUMENTS

int seconds (in) A time value in seconds to be converted to Ascii.

Boolean isInterval (in) If TRUE, interpret the time as a time interval.

char ∗bufferPtr (out,in) A buffer to hold the converted time.

Time ∗timePtr (out) Buffer to hold a time value converted from Ascii.

Time_Parts partsPtr (in/out) Buffer to contain the decomposed time values.

int ∗secondsPtr (out) Place to store time value converted from parts.

DESCRIPTION

The Time_ToAscii and Time_FromAscii procedures convert a time value in seconds to and from Ascii. Time_ToParts converts a time value in seconds into the year, month, day of year, day of month,m day of week, hours, minutes, and seconds. Time_FromParts converts a time value from its parts to seconds. Don’t give it a date before January 1, 1970 and make sure that the day of year corresponds to the month and day of month values. An interval is the difference between two times.

KEYWORDS

ascii, time