.. _adjust-dateTime-to-timezone:

===========================
adjust-dateTime-to-timezone
=========================== 

Adjusts a dateTime to a specific timezone, or no timezone

Description
~~~~~~~~~~~
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.

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.

.. list-table::
   :widths: 40 60
   :header-rows: 1

   * - **Parameters**
     - **Description**
   * - arg:dateTime()
     - the date/time to adjust
   * - timezone:time()
     - the timezone to adjust it to

Examples
~~~~~~~~
.. list-table::
   :widths: 50 50
   :header-rows: 1

   * - **XPath**
     - **Results**
   * - adjust-dateTime-to-timezone(xs:dateTime('2006-02-15T17:00:00'), xs:dayTimeDuration('-PT7H'))
     - 2006-02-15T17:00:00-07:00
   * - adjust-dateTime-to-timezone(xs:dateTime('2006-02-15T17:00:00-03:00'), xs:dayTimeDuration('-PT7H'))
     - 2006-02-15T13:00:00-07:00
   * - adjust-dateTime-to-timezone(xs:dateTime('2006-02-15T17:00:00'), ())
     - 2006-02-15T17:00:00
   * - adjust-dateTime-to-timezone(xs:dateTime('2006-02-15T17:00:00-03:00'), ())
     - 2006-02-15T17:00:00
   * - adjust-dateTime-to-timezone(xs:dateTime('2006-02-15T01:00:00-03:00'), xs:dayTimeDuration('-PT7H'))
     - 2006-02-14T21:00:00-07:00
   * - 
     - 

See Also
~~~~~~~~

.. toctree::
   :titlesonly:
   :glob:

* :ref:`adjust-date-to-timezone`.
* :ref:`adjust-time-to-timezone`.