.. highlightlang:: us

.. index:: DT_SetTime

.. _dt_settime:

DT_SetTime
==========

.. us.tag  DT_SetTime ENGLISH DT_FUNC

:ref:`DT_SetTime` sets the value to the specified time-only value.

.. function::  rvTime = DT_SetTime(rmTime)

.. us.return

**Return Value**

*rvTime* is a real vector. If the time is invalid e.g. ``26:10:10`` the function
returns the value -1e6 (1000000).

.. us.params

**Parameters**

.. uparam:: rmTime

   *rmTime* is a matrix with 3 columns.

   .. list-table::
      :header-rows: 1

      * - Value
        - Meaning
      * - rmTime[;1]
        - Hour (0 to 23)
      * - rmTime[;2]
        - Minute (0 to 59)
      * - rmTime[;3]
        - Second (0 to 59)

.. us.example

**Example**

::

   * DT_SetTime([0, 0, 0; 12, 0, 0; 23,59,10])
   0.0000
   0.5000
   0.9994

.. seealso::
   :ref:`overview-date-and-time`,
   :ref:`DT_GetCurrentTime`,
   :ref:`DT_GetYear`,
   :ref:`DT_GetMonth`,
   :ref:`DT_GetHour`,
   :ref:`DT_GetMinute`,
   :ref:`DT_GetSecond`,
   :ref:`DT_GetDayOfWeek`,
   :ref:`DT_GetDayOfYear`

:sub:`id-1766106`