change_timezone

Definition: include builtins\timedate.e

timedate td = change_timezone(timedate td, string newtz)
Description: Change the timezone on a timedate and adjust the time accordingly.
Comments: For regions with daylight savings, this routine automatically toggles the timedate in and out of out of season.
Example:
include builtins\timedate.e
set_timedate_formats({"h:mmpm tz 'on' Dddd, Mmmm dst, yyyy"})
timedate td = parse_date_string("9:00pm GMT on Friday, July 4th, 2015")
td = change_timezone(td, "BST")
?format_timedate(td)
-- displays "10:00pm BST on Friday, July 4th, 2015")
See Also: timedate, the timedate type, set_timedate_formats, parse_date_string, format_timedate