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