adjust-time-to-timezone
Adjusts a time to a specific timezone, or no timezone
Description
The fn:adjust-time-to-timezone function behaves differently depending on whether the $arg date value already has a time zone, and on the value of the time zone provided.
The $timezone argument is expressed as an xs:dayTimeDuration, for example -PT5H for US Eastern Standard Time. If $timezone is the empty sequence, it is assumed that the desired result is a date value that is in no time zone. If $timezone is omitted from the function call, it is assumed to be the implicit time zone.
If $arg does not already have a time zone, its date part stays the same, but it is now associated with the specified time zone. If $arg already has a time zone, its value is adjusted to that time zone.
Parameters |
Description |
|---|---|
arg:time() |
the time to adjust |
timezone:dateTime() |
the timezone to adjust it to |
Examples
XPath |
Results |
|---|---|
adjust-time-to-timezone(xs:time(‘17:00:00’), xs:dayTimeDuration(‘-PT7H’)) |
17:00:00-07:00 |
adjust-time-to-timezone(xs:time(‘17:00:00-03:00’), xs:dayTimeDuration(‘-PT7H’)) |
13:00:00-07:00 |
adjust-time-to-timezone(xs:time(‘17:00:00’), ()) |
17:00:00 |
adjust-time-to-timezone(xs:time(‘17:00:00-03:00’), ()) |
17:00:00 |
adjust-time-to-timezone(xs:time(‘17:00:00’)) |
17:00:00-05:00 |
adjust-time-to-timezone(xs:time(‘17:00:00’), xs:dayTimeDuration(‘-PT20H’)) |
Error FODT0003 |