Legacy Document

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.