AdjustTimeTZ

STD.Date.TimeZone.AdjustTimeTZ( time,fromTimeZoneAbbrev, toTimeZoneAbbrev, [fromLocation, ] [toLocation ] )

timeREQUIRED. The time value (in Time_t format) to adjust.
fromTimeZoneAbbrevREQUIRED. The time zone abbreviation that the time value is assumed to be within; must be a non-empty uppercase string.
toTimeZoneAbbrevREQUIRED. The time zone abbreviation designated as the ending point; must be a non-empty uppercase string.
fromLocationOPTIONAL. The name of the location that goes along with fromTimeZoneAbbrev; if a location is not provided or is an empty string, the first record matching fromTimeZoneAbbrev is used.
toLocationOPTIONAL. The name of the location that goes along with toTimeZoneAbbrev; if a location is not provided or is an empty string, the first record matching toTimeZoneAbbrev is used.
Returns:The given time value (in Time_t format) adjusted by the difference between the two given time zones; if either time zone cannot be found then the original time value is returned unchanged.

The STD.Date.TimeZone.AdjustTimeTZ function adjusts a given Time_t time value for another time zone. Both the given time and the destination time zone are designated by a required time zone abbreviation and an optional location name.

Example:

IMPORT STD;
STD.Date.TimeZone.AdjustTimeTZ(205246,'CST','IST','NORTH AMERICA','');

See Also: SecondsBetweenTZ