.. _adjust-date-to-timezone:

=======================
adjust-date-to-timezone
======================= 

Adjusts a date to a specific timezone, or no timezone

Description
~~~~~~~~~~~
The fn:adjust-date-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.

The $arg date is assumed for the sake of time zone calculation to be just like 
an xs:dateTime value whose time is midnight (00:00:00). 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:date()
     - the date to adjust
   * - timezone:dateTime()
     - the timezone to adjust it to

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

   * - **XPath**
     - **Results**
   * - adjust-date-to-timezone(xs:date('2006-02-15'), xs:dayTimeDuration('-PT8H'))
     - 2006-02-15-08:00
   * - adjust-date-to-timezone(xs:date('2006-02-15-03:00'), xs:dayTimeDuration('-PT8H'))
     - 2006-02-14-08:00
   * - adjust-date-to-timezone(xs:date('2006-02-15'), ())
     - 2006-02-15
   * - adjust-date-to-timezone(xs:date('2006-02-15-03:00'), ())
     - 2006-02-15
   * - 
     - 

See Also
~~~~~~~~

.. toctree::
   :titlesonly:
   :glob:

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