Definition: |
include builtins\timedate.e
timedate td = set_timezone(timedate td, string newtz) |
Description: | Set the timezone on an un-timezoned timedate. |
Comments: |
If the timedate already has a timezone it is returned unchanged. To forcibly change
an existing timezone and adjust the time accordingly, use change_timezone().
For regions with daylight savings, always use the daylight savings code, even when it is out of season. This will create a timedate that has the correct auto-toggling feature when subsequently adjusted using the adjust_timedate() function. |
Example: |
include builtins\timedate.e set_timedate_formats({"h:mmpm tz 'on' Dddd, Mmmm dst, yyyy", "h:mmpm 'on' Dddd, Mmmm dst, yyyy"}) timedate td = parse_date_string("9:00pm on Friday, July 4th, 2015") td = set_timezone(td, "BST") ?format_timedate(td) -- displays "9:00pm BST on Friday, July 4th, 2015") |
See Also: | timedate, the timedate type, change_timezone, adjust_timedate, set_timedate_formats, parse_date_string, format_timedate |