.TZNAME - determine name of a time zone.

Alternate Entry Name: _TZNAME

Usage:

B:
   %b/manif/t_ctrl
   name = .tzname(tzref);

C:
   #include <t_ctrl.h>
   const char *_tzname(_T_time_zone tzref);

Where:

tzref

is a time zone reference value, as returned by .TZQRY.

name

points to a string that is the name of the time zone (e.g. "EST"). If "tzref" is not a valid time zone reference value, .TZNAME returns a pointer to an empty string.

NOTE: The pointer that .TZNAME returns is a C pointer, not a B pointer. In most programs this makes no difference, since all the library functions accept either B or C pointers. However, if you do more with "name" than just pass it to a library function, you should remember to treat it as a C pointer rather than a B pointer.

Description:

.TZNAME returns the name associated with a particular time zone.

See Also:

expl b tz

for background on time zones.

expl b lib .tzqry

for obtaining time zone reference values.

Copyright © 1996, Thinkage Ltd.