.. _functx_date:

===========
functx:date
=========== 

Construct a date from a year, month and day

Description
~~~~~~~~~~~
The functx:date function constructs an xs:date value from arguments representing 
the year, month and day. The arguments can have any type that can be cast to 
xs:integer. If the combination does not result in a valid date (e.g. the day is 
32 or the month is 13), an error is raised.

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

   * - **Parameters**
     - **Description**
   * - year:date()
     - the year
   * - month:date()
     - the month
   * - day:date()
     - the day

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

   * - **XPath**
     - **Results**
   * - functx:date(2006,6,12)
     - 2006-06-12
   * - functx:date('2006','06','12')
     - 2006-06-12

Depends On
~~~~~~~~~~
* :ref:`functx_pad-integer-to-length`.

See Also
~~~~~~~~

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_time`.