.. _format-dateTime:

===============
format-dateTime
=============== 

Formata uma data e hora

Descrição
~~~~~~~~~
A função fn:format-dateTime formata $value como string, usando a máscara 
indicada em $picture, o calendário indicado em $calendar, o idioma indicado em 
$language e o país indicado em $country. A sintaxe da máscara está na seção 
16.5.1 da recomendação XSLT 2.0. Os três últimos argumentos são opcionais, mas, 
se você informar um, precisa informar os três (pode passar a sequência vazia). 
Observação: é uma função só do XSLT; não existe em XQuery nem em XPath puro.

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

   * - **Parâmetros**
     - **Descrição**
   * - value:dateTime()
     - a data e hora a formatar
   * - picture:string()
     - a máscara, feita de componentes entre colchetes, como [Y], [M01] ou [D]
   * - language:string()
     - o idioma dos nomes de meses e dias, como en; opcional
   * - calendar:string()
     - o calendário a usar, como AD; opcional
   * - country:string()
     - o país, usado para escolher nomes e fusos horários; opcional

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

   * - **XPath**
     - **Resultado**
   * - format-dateTime(xs:dateTime('2006-02-15T13:30:05'), '[Y0001]-[M01]-[D01] [H01]:[m01]:[s01]')
     - 2006-02-15 13:30:05
   * - format-dateTime(xs:dateTime('2006-02-15T13:30:05'), '[D]/[M]/[Y] [h]:[m01] [P]')
     - 15/2/2006 1:30 p.m.

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`format-date`.
* :ref:`format-time`.
* :ref:`functx_day-of-week-name-en`.
* :ref:`functx_day-of-week-abbrev-en`.
* :ref:`functx_month-name-en`.
* :ref:`functx_month-abbrev-en`.