30.5. $addDefinedTimeZone

$addDefinedTimeZone adds another time zone to the list of time zones known to the MAINSAIL runtime system. tzName is the commonly used (usually abbreviated) name of a time zone, and gmtOffset is its offset in seconds from GMT (zones west of Greenwich are positive numbers). A separate call is needed to enter the corresponding Daylight Savings Time zone, if there is one. For example, to set up the zone names for the Pacific Time Zone:

$addDefinedTimeZone("PDT",25200L);
$addDefinedTimeZone("PST",28800L);

The values of the time zones known to MAINSAIL may be examined by $getDefinedTimeZones or by the MAINEX subcommand DEFINETIMEZONE. MAINSAIL's time-zone-related facilities are described in more detail in Section 24.2 and in the description of MAINEX in Chapter 21 of the MAINSAIL Utilities User's Guide.

$addDefinedTimeZone does not affect the value of $timeSubcommandsSet (see Section 48.13).