.TZQRY - convert time zone name to time zone reference.

Alternate Entry Name: _TZQRY

Usage:

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

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

Examples:

tzref = .tzqry("EST");

Where:

name

is the name of a time zone that is defined in the current time zone definitions.

tzref

is a time zone reference value representing that time zone.

Description:

.TZQRY converts a time zone name to a time zone reference value. You can then feed this value as an argument to functions like .TZNAME, .TZOFF, and .TZISDST.

If "name" is not the name of a recognized time zone, .TZQRY returns a reference value indicating the error time zone. However, this doesn't really let you determine whether the "name" is the name of a recognized time zone. The best way to do that is to call .TZNAME on the result of .TZQRY and see if the function returns a pointer to an empty string.

See Also:

expl b tz

for background on time zones and the error time zone.

Copyright © 1996, Thinkage Ltd.