Gets the time zone label and offset from GMT, using the TDF
contained in the input utc.
Format
#include <utc.h>
int utc_anyzone(tzname, tzlen, *tdf, isdst, *utc)
char tzname;
size_t tzlen;
long *tdf;
int *isdst;
const utc_t *utc;
1 – Parameters
Input
tzlen
Length of the tzname buffer.
utc
Binary time.
Output
tzname
Character string that is long enough to hold the time zone label.
tdf
Longword with differential in seconds east or west of GMT.
isdst
Integer with a value of -1, indicating that no information is
supplied as to whether it is standard time or daylight saving
time. A value of -1 is always returned.
2 – Description
The Any Zone routine gets the time zone label and offset from
GMT, using the TDF contained in the input utc. The label returned
is always of the form GMT + n or GMT - n, where n is the TDF
expressed in hours:minutes. (The label associated with an
arbitrary time zone is not known; only the offset is known.)
3 – Notes
All of the output parameters are optional. No value is returned
and no error occurs if the pointer is null.
4 – Returns
0 Indicates that the routine executed successfully.
-1 Indicates an invalid time argument or an insufficient buffer.
5 – Example
See the sample program for the utc_anytime routine.
6 – Related Functions
utc_anytime, utc_gmtzone, utc_localzone