STD.Date.TimeZone.AdjustTimeTZ( time,fromTimeZoneAbbrev, toTimeZoneAbbrev, [fromLocation, ] [toLocation ] )
| time | REQUIRED. The time value (in Time_t format) to adjust. |
| fromTimeZoneAbbrev | REQUIRED. The time zone abbreviation that the time value is assumed to be within; must be a non-empty uppercase string. |
| toTimeZoneAbbrev | REQUIRED. The time zone abbreviation designated as the ending point; must be a non-empty uppercase string. |
| fromLocation | OPTIONAL. 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. |
| toLocation | OPTIONAL. 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