.. _functx_first-day-of-month:

=========================
functx:first-day-of-month
========================= 

O primeiro dia do mês de uma data

Descrição
~~~~~~~~~
A função functx:first-day-of-month devolve o primeiro dia do mês de $date, como 
xs:date.

O argumento $date precisa poder ser convertido em xs:date, ou seja, ser do tipo 
xs:date ou xs:dateTime, ou uma xs:string ou um valor sem tipo no formato 
AAAA-MM-DD.

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

   * - **Parâmetros**
     - **Descrição**
   * - date:date()
     - a data

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

   * - **XPath**
     - **Resultado**
   * - functx:first-day-of-month(xs:date('2004-01-23'))
     - 2004-01-01
   * - functx:first-day-of-month(xs:dateTime('2004-01-23T12:00:13'))
     - 2004-01-01
   * - functx:first-day-of-month('2004-03-23')
     - 2004-03-01

Depende de
~~~~~~~~~~
* :ref:`functx_date`.

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

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_last-day-of-month`.
* :ref:`functx_first-day-of-year`.