.. _format-date:

===========
format-date
=========== 

Formata uma data

Descrição
~~~~~~~~~
A função fn:format-date 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:date()
     - a data 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: 25 25 50
   :header-rows: 1

   * - **XPath**
     - **Resultado**
     - **Explicação**
   * - format-date(xs:date('2006-02-15'), '[D]/[M]/[Y]')
     - 15/2/2006
     - Dia, mês e ano sem zeros à esquerda.
   * - format-date(xs:date('2006-02-15'), '[Y0001]-[M01]-[D01]')
     - 2006-02-15
     - Ano com quatro dígitos, mês e dia com dois.
   * - format-date(xs:date('2006-02-15'), '[MNn] [D], [Y]')
     - February 15, 2006
     - MNn é o nome do mês com a inicial maiúscula.
   * - format-date(xs:date('2006-02-15'), '[FNn], [D1o] [MNn] [Y]')
     - Wednesday, 15th February 2006
     - FNn é o dia da semana, e D1o é o dia como número ordinal.
   * - format-date(xs:date('2006-02-15'), '[D] de [MNn] de [Y]', 'pt', (), ())
     - [Language: en]15 de February de 2006
     - Os nomes de meses e dias só existem em inglês: outros idiomas caem no inglês, e o resultado avisa isso.

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`format-dateTime`.
* :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`.