Previous Book Contents Book Index Next

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.

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

Previous Book Contents Book Index Next

© Apple Computer, Inc.
11 NOV 1996