Design

Back Next

adjust-dateTime-to-timezone

Adjusts a dateTime value to a specific time zone, or removes the time zone component from the dateTime value.

Syntax

fn:adjust-dateTime-to-timezone(arg, timezone)

The following table describes the arguments:

Argument	Required/ Optional	Description
arg	Required	The dateTime value that is to be adjusted. The dateTime-value is of type xs:dateTime or is an empty sequence.
timezone	Optional	A duration that represents the time zone to which dateTime-value is to be adjusted.

Return Value

The fn:adjust-dateTime-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 as given below:

The $timezone argument is expressed as an xs:dayTimeDuration, for example -PT5H for US Eastern Standard Time.

If $timezone is an empty sequence, returns an xs:dateTime without a time zone. Otherwise, returns an xs:dateTime with a time zone.

If $arg already has a time zone, its value is adjusted to that time zone.

If $arg does not already have a time zone, its date part stays the same, and the time is associated with the specified time zone.

If $timezone is omitted from the function call, it is assumed to be the implicit time zone.

Examples

The following table contains examples and return values for the adjust-date-to-timezone function:

Examples	Return Values
adjust-dateTime-to-timezone( xs:dateTime('2023-02-15T17:00:00'), xs:dayTimeDuration('-PT7H'))	2023-02-15T17:00:00-07:00
adjust-dateTime-to-timezone( xs:dateTime('2023-02-15T17:00:00-03:00'), xs:dayTimeDuration('-PT7H'))	2023-02-15T13:00:00-07:00
adjust-dateTime-to-timezone( xs:dateTime('2023-02-15T17:00:00'), ())	2023-02-15T17:00:00
adjust-dateTime-to-timezone( xs:dateTime('2023-02-15T17:00:00-03:00'), ())	2023-02-15T17:00:00
adjust-dateTime-to-timezone( xs:dateTime('2023-02-15T01:00:00-03:00'), xs:dayTimeDuration('-PT7H'))	2023-02-14T21:00:00-07:00

The following table contains examples and return values assuming an implicit time zone of -05:00:

Examples	Return Values
adjust-dateTime-to-timezone( xs:dateTime('2023-02-15T17:00:00'))	2023-02-15T17:00:00-05:00
adjust-dateTime-to-timezone( xs:dateTime('2023-02-15T17:00:00-03:00'))	2023-02-15T15:00:00-05:00