Get the time zone change from a CLOCK_INFO event.
Synopsis:
#include <bps/clock.h>
BPS_API const char* clock_event_get_time_zone_change(bps_event_t *event)
Arguments:
- event
-
The CLOCK_INFO event to extract the time zone change from.
Library:
libbps (For the qcc command, use the -l bps option to link against this library)
Description:
The clock_event_get_time_zone_change() function extracts the time zone change from the specified CLOCK_INFO event. The format of the returned time zone is as follows:
std offset_std dst offset_dst, rule_to, rule_from
where:
- std specifies the standard time zone (for example, EST).
- offset_std specifies the value you must add to the standard time to arrive at Coordinated Universal Time (UTC) (for example, 5 or 05 for Eastern Standard Time).
- dst specifies the daylight saving time zone (for example, EDT). If dst is omitted, then daylight saving time doesn't apply in this locale.
- offset_dst specifies the value you must add to the daylight saving time to arrive at UTC (for example, 4 or 04 for Eastern Daylight Time).
- rule_to indicates when to change to daylight saving time. The format of rule_to is Mm.n.d/time, which means day d (0 <= d <= 6) of week n (1 <= n <= 5) of month m (1 <= m <= 12) of the year. time indicates, in local time, when the change occurs.
- rule_from indicates when to change from daylight saving time back to standard time. The format of rule_from is the same as the format of rule_to.
The following is an example of this format for Eastern Standard Time:
EST05EDT04,M3.2.0/2,M11.1.0/2
Returns:
The time zone change.