Converting Between Long Date-Time Format

Mac OS X header:	CoreServices/CoreServices.h
Mac OS 9 header:	DateTimeUtils.h

Converting Between Long Date-Time Format Functions
LongDateToSeconds	Converts a date and time to the number of seconds elapsed since midnight, January 1, 1904.
LongSecondsToDate	Converts the number of seconds elapsed since midnight, January 1, 1904 to a date and time.

Converts a date and time to the number of seconds elapsed since midnight, January 1, 1904.

void LongDateToSeconds (
    const LongDateRec *lDate, 
    LongDateTime *lSecs
);

Parameter descriptions

lDate

The long date-time structure containing the date and time to convert.

lSecs

On return, the number of seconds elapsed since midnight, January 1, 1904, and the time specified in the lDate parameter. The number of seconds are returned as a long date-time value.

Discussion

The system software uses the LongDateToSeconds function provided by the current script system.

The LongDateToSeconds function is also available as the LongDate2Secs function. The LongDate2Secs function was previously available with the Script Manager.

To learn more about the long date-time value, see LongDateTime. For more information on the long date-time record, see LongDateRec.

Availability

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Converts the number of seconds elapsed since midnight, January 1, 1904 to a date and time.

void LongSecondsToDate (
    const LongDateTime *lSecs, 
    LongDateRec *lDate
);

Parameter descriptions

lSecs

The number of seconds elapsed since midnight, January 1, 1904.

lDate

On return, the fields of the long date-time structure that contain the date and time corresponding to the value indicated in the lSecs parameter. For example, specifying the number of seconds 41627 results in the date and time 5:50 A.M. on June 13, 1990 being returned in this parameter.

Discussion

The system software uses the LongSecondsToDate function provided by the current script system.

The LongSecondsToDate function is also available as the LongSecs2Date function. The LongSecs2Date function was previously available with the Script Manager.

To learn more about the long date-time value, see LongDateTime. For more information on the long date-time record, see TogglePB.

Availability

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2001 Apple Computer, Inc. (Last Updated July 17, 2001)