.. highlightlang:: us

.. index:: DT_GetCurrentTime

.. _dt_getcurrenttime:

DT_GetCurrentTime
=================

.. us.tag  DT_GetCurrentTime NOTREADYENGLISH DT_FUNC Changed5403

:ref:`DT_GetCurrentTime` returns the current date/time as a real number.

.. function::  r = DT_GetCurrentTime()
			   r = DT_GetCurrentTime(bUTC)

.. us.return

**Return Value**

*r* is a real number representing the current date/time.

.. us.params

**Parameters**

.. uparam:: bUTC

   If *bUTC* is TRUE, the function returns the UTC-Zeit (Universal Time
   Coordinated) and not the local time. Default is FALSE.
   See also :ref:`DT_GetTimeZoneOffsets`.

.. us.example

**Example**

::

   * r = DT_GetCurrentTime()
   * r
   35991.6003
   * DT_Format(DT_GetCurrentTime(), "%c")
   15.07.98 14:24:34
   * DT_Format(DT_GetCurrentTime(), "%x")
   15.07.98
   * DT_Format(DT_GetCurrentTime(), "%X")
   14:24:38
   * DT_Format(r, "Today is %A, day %d of %B in the year %Y.")
   Today is wednesday, day 15 of July in the year 1998.

.. us.history

**History**

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

   * - Version
     - Description
   * - R2012.3 (5.40.3)
     - New Parameter *bUTC*.

.. seealso::
   :ref:`overview-date-and-time`,
   :ref:`DT_GetTimeZoneOffsets`,
   :ref:`DT_Format`,
   :ref:`DT_GetDay`,
   :ref:`DT_GetDayOfWeek`,
   :ref:`DT_GetDayOfYear`,
   :ref:`DT_GetHour`,
   :ref:`DT_GetMinute`,
   :ref:`DT_GetMonth`,
   :ref:`DT_GetSecond`,
   :ref:`DT_GetYear`,
   :ref:`DT_ParseDateTime`,
   :ref:`DT_SetDate`,
   :ref:`DT_SetDateTime`,
   :ref:`DT_SetLocale`,
   :ref:`DT_SetTime`

:sub:`id-255139`