.. _format-time:

===========
format-time
=========== 

Formata uma hora

Descrição
~~~~~~~~~
A função fn:format-time 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:time()
     - a hora a formatar
   * - picture:string()
     - a máscara, feita de componentes entre colchetes, como [H01] ou [m01]
   * - 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-time(xs:time('13:30:05'), '[H01]:[m01]')
     - 13:30
   * - format-time(xs:time('13:30:05'), '[h]:[m01] [P]')
     - 1:30 p.m.

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

.. toctree::
   :titlesonly:
   :glob:

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