Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Inside Macintosh: Advanced Color Imaging Reference /: Chapter 3 - ColorSync Manager Reference for Applications and Device Drivers / Constants and Data Types

Date and Time Structure
The ColorSync Manager defines the CMDateTime data structure to specify a date and time in year, month, day of the month, hours, minutes, and seconds. Other ColorSync structures use the CMDateTime structure to specify information such as the creation date or calibration date for a color space profile.
The CMDateTime structure is similar to the Macintosh Toolbox structure DateTimeRec, and like it, is intended to hold date and time values only for a Gregorian calendar.

Note
The CMDateTime structure is platform independent. However, when used with Macintosh Toolbox routines such as SecondsToDate and DateToSeconds, it suffers the same limitations as those functions, including the limitation that the year can only range from 1904 to 2040.
struct CMDateTime {
   unsigned short year;
   unsigned short month;
   unsigned short dayOfTheMonth;
   unsigned short hours;
   unsigned short minutes;
   unsigned short seconds;
};
Field Description

year
The year. Note that to indicate the year 1984, this field would store the integer 1984, not just 84.
month
The month of the year, where 1 represents January, and 12 represents December.
dayOfTheMonth
The day of the month, ranging from 1 to 31.
hours
The hour of the day, ranging from 0 to 23, where 0 represents midnight and 23 represents 11:00 P.M.
minutes
The minutes of the hour, ranging from 0 to 59.
seconds
The seconds of the minute, ranging from 0 to 59.