.TSWITCH - change to a new time zone locale.
Alternate Entry Name: _TSWITCH
Usage:
B:
%b/manif/t_ctrl
tz = .tswitch(localename);
C:
#include <t_ctrl.h>
_T_locale _tswitch(const char *localename);
Examples:
old = .tswitch("US/EST");
Where:
- localename
- is the name of a locale that is recognized in the current
time zone definitions.
- tz
- is the previous time zone locale. If the specified
"localename" is not the name of a recognized
time zone locale, according to the current time zone
definition file, .TSWITCH returns zero and does not
change the time zone locale.
Description:
.TSWITCH changes to a new time zone locale. All subsequent
time zone calculations will be made in the context of that
locale.
The .TINIT function automatically issues the call
.tswitch("default");
so that the program starts working in the default locale.
See Also:
- expl b tz
- for background on time zones.
- expl b lib .tinit
- for setting time zone definitions.
Copyright © 1996, Thinkage Ltd.