.. highlightlang:: us

.. index:: DT_SetDateTime

.. _dt_setdatetime:

DT_SetDateTime
==============

.. us.tag  DT_SetDateTime ENGLISH DT_FUNC

:ref:`DT_SetDateTime` sets the value to the specified date/time value.

.. function::  rvDateTime = DT_SetDateTime(rmDateTime)

.. us.return

**Return Value**

*rvDateTime* is a real vector. If the date/time invalid for example
``February 29, 1998 15:10:10`` the function returns the value -1e6 (1000000).

.. us.params

**Parameters**

.. uparam:: rmDateTime

   *rmDateTime* is a matrix with 6 columns.

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

   * - Value
     - Meaning
   * - rmDateTime[;1]
     - Year (100 to 9999)
   * - rmDateTime[;2]
     - Month (1 to 12)
   * - rmDateTime[;3]
     - Day (1 to 31)
   * - rmDateTime[;4]
     - Hour (0 to 23)
   * - rmDateTime[;5]
     - Minute (0 to 59)
   * - rmDateTime[;6]
     - Second (0 to 59)

.. us.comment

**Comment**

For more information about the ``DT_``-functions see :ref:`DT_GetCurrentTime`.

.. us.example

**Example**

::

   * DT_SetDateTime([1998, 1, 1, 12, 0, 0; 1998, 1,2, 18, 0, 0])
   35796.5
   35797.75

.. 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-620504`