Important: The information in this document is obsolete and should not be used for new development.
LongDateString
TheLongDateString
procedure converts a date that is specified as aLongDateTime
value into a Pascal string, making use of the date formatting information in the specified resource.
PROCEDURE LongDateString(VAR dateTime: LongDateTime; longFlag: DateForm; VAR result: Str255; intlParam: Handle);
dateTime
- A 64-bit, signed representation of the number of seconds since Jan. 1, 1904.
longFlag
- A flag that indicates the desired format for the date string. This is one of the three values defined as the
DateForm
type.result
- On output, contains the string representation of the date in the format indicated by the
longFlag
parameter.intlParam
- A handle to a numeric-format or long-date-format resource that specifies date formatting information for use in the conversion. The numeric-format (
'itl0'
) resource specifies the short date formats and the long-date-format ('itl1'
) resource specifies the long date formats.DESCRIPTION
LongDateString
converts theLongDateTime
value in thedateTime
parameter into a Pascal string representation of the date. You can use theLongSecondsToDate
andLongDateToSeconds
procedures, which are described in the book Inside Macintosh: Operating System Utilities, to convert between theLongDateRec
(as produced by theStringToDate
function) andLongDateTime
data types.The string produced by
LongDateString
is in one of three standard date formats used on the Macintosh, depending on which of the threeDateForm
values that you specify for thelongFlag
parameter:shortDate
,abbrevDate
, orlongDate
. The information in the supplied resource defines how month and day names are written and provides for calendars with more than 7 days and more than 12 months. For the U.S. resource, the date January 31, 1991, produces the following three strings:
DateForm value Date string produced shortDate 1/31/92 abbrevDate Fri, Jan 31, 1992 longDate Friday, January 31, 1992
LongDateString
formats its data according to the information in the specified numeric-format resource (for short date formats) or long-date-format resource (for long date formats). If you specifyshortDate
, theintlParam
value should be the handle to a numeric-format resource; if you specifyabbrevDate
orlongDate
, it should be the handle to a long-date-format resource. If theintlParam
value isNIL
,LongDateString
uses the resource from the current script.SPECIAL CONSIDERATIONS
LongDateString
may move memory; your application should not call this procedure at interrupt time.ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for theLongDateString
procedure are
Trap macro Selector _Pack6 $0014