.. _functx_first-day-of-year:

========================
functx:first-day-of-year
======================== 

The first day of the year of a date

Description
~~~~~~~~~~~
The functx:first-day-of-year function returns the date representing the first 
day of the year of $date as an xs:date value.

The $date argument must be castable to xs:date, meaning that it must have the 
type xs:date or xs:dateTime, or be an xs:string or untyped value of the form 
YYYY-MM-DD.

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

   * - **Parameters**
     - **Description**
   * - date:date()
     - the date

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

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

Depends On
~~~~~~~~~~
* :ref:`functx_date`.

See Also
~~~~~~~~

.. toctree::
   :titlesonly:
   :glob:

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