.. _functx_time:

===========
functx:time
=========== 

Construct a time from an hour, minute and second

Description
~~~~~~~~~~~
The functx:time function constructs an xs:time value from arguments representing 
the hour, minute and second. The arguments can have any type that can be cast to 
xs:integer. If the combination does not result in a valid time (e.g. the hour is 
25 or the minute is 61), an error is raised. The function does not currently 
support decimal numbers for $second.

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

   * - **Parameters**
     - **Description**
   * - hour:time()
     - the hour
   * - minute:time()
     - the minute
   * - second:time()
     - the second

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

   * - **XPath**
     - **Results**
   * - functx:time(20,6,12)
     - 20:06:12
   * - functx:time('20','6','12')
     - 20:06:12

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

See Also
~~~~~~~~

.. toctree::
   :titlesonly:
   :glob:

* :ref:`functx_date`.