clock_event_get_date

Get the date change from a CLOCK_INFO event.

Synopsis:

#include <bps/clock.h>

BPS_API int clock_event_get_date_change(bps_event_t *event)

Since:

BlackBerry 10.0.0

Arguments:

event: The CLOCK_INFO event to extract the date change from.

Library:

libbps (For the qcc command, use the -l bps option to link against this library)

Description:

The clock_event_get_date_change() function extracts the date change from the specified CLOCK_INFO event. The date change is returned as seconds since the epoch, where the epoch is midnight on January 1, 1970 UTC.

Note that the date change that this function returns is the last date and time that was set by the user. This may or may not be the current time. For example, if the user changes the time to 3:52 PM, this function will report the date change as 3:52 PM, even after that time has passed. This function will continue to report the date change as 3:52 PM until the user resets the time manually.

Returns:

The date change (in seconds since the epoch).