Newton Developer Technical Information: Newton Programmer's Guide: 2.1 OS Addendum /

Chapter 11 - Miscellaneous / Reference

Functions and Methods / Utility Functions

TimeFrameStr

TimeFrameStr(timeFrame, timeStrSpec)

Returns a string representation of the time timeFrame, in the specified format.

timeFrame

A date frame as returned by the Date function.

timeStrSpec

A format specification returned by the GetDateStringSpec function, or one of the format specifications found in ROM_dateTimeStrSpecs.

return value

A string representation timeFrame.

DISCUSSION

This function is similar to the TimeStr function. The TimeStr function is passed in the time as an integer, the number of minutes since 1/1/04; this is what the Time function returns. Thus, when the a format spec is provided that requires seconds, TimeStr returns a string with 00 as the seconds value. *TimeFrameStr, on the other hand, since it is passed the time as a date frame, can include seconds information.