# 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.
pwa/p2js: | Supported.
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