Function

CFAbsoluteTimeGetDifferenceAsGregorianUnits

Computes the time difference between two specified absolute times and returns the result as an interval in Gregorian units.

Declaration

CFGregorianUnits CFAbsoluteTimeGetDifferenceAsGregorianUnits(CFAbsoluteTime at1, CFAbsoluteTime at2, CFTimeZoneRef tz, CFOptionFlags unitFlags);

Parameters

at1

An absolute time.

at2

An absolute time.

tz

The time zone to use for time correction. Pass NULL for GMT.

unitFlags

A mask that specifies which Gregorian unit fields to use when converting the absolute time difference into a Gregorian interval. See CFGregorianUnitFlags for a list of values from which to construct the mask.

Return Value

The difference between the specified absolute times (as at1 - at2—if at1 is earlier than at2, the result is negative) expressed in the units specified by unitFlags.

Discussion

The temporal difference is expressed as accurately as possible, given the units specified. For example, if you asked for the number of months and hours between 2:30pm on April 8 2005 and 5:45pm September 9 2005, the result would be 5 months and 27 hours.

The following example prints the number of hours and minutes between the current time (now) and the reference date (1 January 2001 00:00:00 GMT).

CFAbsoluteTime now = CFAbsoluteTimeGetCurrent ();
 
CFGregorianUnits units = CFAbsoluteTimeGetDifferenceAsGregorianUnits
    (now, 0, NULL, (kCFGregorianUnitsHours | kCFGregorianUnitsMinutes));
 
CFStringRef output = CFStringCreateWithFormat
    (NULL, 0, CFSTR("hours: %d; minutes: %d"), units.hours, units.minutes);
CFShow(output);

See Also

Core Foundation Time Utilities Miscellaneous Functions

CFAbsoluteTimeAddGregorianUnits

Adds a time interval, expressed as Gregorian units, to a given absolute time.

Deprecated
CFAbsoluteTimeGetCurrent

Returns the current system absolute time.

CFAbsoluteTimeGetDayOfWeek

Returns an integer representing the day of the week indicated by the specified absolute time.

Deprecated
CFAbsoluteTimeGetDayOfYear

Returns an integer representing the day of the year indicated by the specified absolute time.

Deprecated
CFAbsoluteTimeGetGregorianDate

Converts an absolute time value into a Gregorian date.

Deprecated
CFAbsoluteTimeGetWeekOfYear

Returns an integer representing the week of the year indicated by the specified absolute time.

Deprecated
CFGregorianDateGetAbsoluteTime

Converts a Gregorian date value into an absolute time value.

Deprecated
CFGregorianDateIsValid

Checks the specified fields of a CFGregorianDate structure for valid values.

Deprecated