.. _adjust-dateTime-to-timezone:

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

Ajusta um dateTime para um fuso horário, ou para nenhum

Descrição
~~~~~~~~~
A função fn:adjust-dateTime-to-timezone se comporta de um jeito diferente 
conforme o valor $arg já tenha fuso horário ou não, e conforme o fuso informado.

O argumento $timezone é um xs:dayTimeDuration, por exemplo -PT5H para o horário 
padrão da costa leste dos EUA. Se $timezone for a sequência vazia, entende-se 
que o resultado deve ficar sem fuso. Se $timezone for omitido, vale o fuso 
implícito.

Se $arg ainda não tiver fuso, a data e a hora ficam iguais, mas passam a ter o 
fuso indicado. Se $arg já tiver fuso, o valor é ajustado para o novo fuso.

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

   * - **Parâmetros**
     - **Descrição**
   * - arg:dateTime()
     - a data e hora a ajustar
   * - timezone:time()
     - o fuso horário de destino

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

   * - **XPath**
     - **Resultado**
   * - 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

Os exemplos a seguir supõem um fuso horário implícito de -05:00:

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

   * - **XPath**
     - **Resultado**
   * - adjust-dateTime-to-timezone(xs:dateTime('2006-02-15T17:00:00'))
     - 2006-02-15T17:00:00-05:00
   * - adjust-dateTime-to-timezone(xs:dateTime('2006-02-15T17:00:00-03:00'))
     - 2006-02-15T15:00:00-05:00

Veja também
~~~~~~~~~~~

.. toctree::
   :titlesonly:
   :glob:

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