navigator_invoke_specific_time_set_time

Set the time_zone of a specific time structure.

Synopsis:

#include <bps/navigator_invoke.h>

BPS_API int navigator_invoke_specific_time_set_time_zone(navigator_invoke_specific_time_t *specific_time,
                                                         const char *time_zone)

Since:

BlackBerry 10.3.0

Arguments:

specific_time: The navigator_invoke_specific_time_t structure to modify.

time_zone: The time zone ID to set.

Library:

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

Description:

This function sets the time_zone of a navigator_invoke_specific_time_t structure.

The time zone ID can be a programmatic ID such as "America/Los_Angeles" which is defined in the standard Olson/IANA timezone database used by UNIX systems. The programmatic ID has the format continent/city or ocean/city. The time zone ID can also be a custom ID such as "GMT-8:00". The custom ID has the syntax "GMT[+|-]hh[[:]mm]". A list of supported time zone IDs can be obtained by calling ucal_openTimeZones() declared in header file <unicode/ucal.h> The wikipedia link http://en.wikipedia.org/wiki/List_of_tz_database_time_zones has a list of time zones in the programmatic ID format. Please use the latter with caution, as some of these may or may not be supported on your platform.

Returns: