Important: The information in this document is obsolete and should not be used for new development.
TimeString
TheTimeString
procedure converts a time in the standard date-time representation into a string, making use of the time formatting information in the specified resource.
PROCEDURE TimeString (dateTime: LongInt; wantSeconds: Boolean; VAR result: Str255; intlParam: Handle);
dateTime
- The date-time value in the representation returned by the Operating System procedure
GetDateTime
.wantSeconds
- A flag that indicates whether the seconds are to be included in the resulting string.
result
- On output, contains the string representation of the time.
intlParam
- A handle to a numeric-format (
'itl0'
) resource that specifies time formatting information for use in the conversion.DESCRIPTION
TimeString
converts the long integer representation of date and time in thedateTime
parameter into a Pascal string representation of the time. You can call theGetDateTime
function to get the date-time value.GetDateTime
is described in the book Inside Macintosh: Operating System Utilities.
TimeString
produces a string that includes the seconds if you set thewantSeconds
parameter toTRUE
.
TimeString
formats its data according to the information in the numeric-format resource specified in theintlParam
parameter. If this value isNIL
,TimeString
uses the numeric-format resource from the current script. The numeric-format resource specifies whether or not to use leading zeros for the time values, whether to use a 12- or 24-hour time cycle, and how to specify morning or evening if a 12-hour time cycle is used.SPECIAL CONSIDERATIONS
TimeString
may move memory; your application should not call this procedure at interrupt time.ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for theTimeString
procedure are
Trap macro Selector _Pack6 $0010