.. highlightlang:: us

.. index:: DT_UnixTime

.. _DT_UnixTime:

DT_UnixTime
============

.. us.tag  DT_UnixTime GERMAN DT_FUNC New5905

:ref:`DT_UnixTime` konvertiert die Unixzeit in die Zeitwerte von UniPlot. Die
Zeit kann in Sekunden, Millisekunden oder Microsekunden angegeben werden.

.. function::  rvDateTime = DT_UnixTime(rvUnixTime)
    rvDateTime = DT_UnixTime(rvUnixTime, ssUnit)

.. us.return

**Returnwert**

*rvDateTime* ist ein Vektor mit den von UniPot verwendeten Zeitformat: Der 
ganzzahlige Anteil sind die Tage seit dem 31 Dezember 1899, Mitternacht um 0 Uhr. 
Die Stunden ist der Bruchteil der Zahl. Falls ein Fehler auftritt, liefert die
Funktion den Wet -1.

.. us.params

**Parameter**

.. uparam:: rvUnixTime

   *rvUnixTime* ist ein reeller Vektor mit der Unixzeit. 
   Die Unixzeit zählt die vergangenen Sekunden seit Donnerstag, dem 1. Januar 
   1970.

.. uparam:: ssUnit

   Text mit der Einheit der Unixzeit: ``s``, ``ms`` or ``μs`` 
   Falls der Parameter nicht angegeben wird, ermittelt die Funktion die Einheit
   wie folgt::

     if (all(rvUnixTime > 5e8 && rvUnixTime < 1.9e9)) {  //  05.11.1985 to 17.03.2030
          ssUnit = "s";
     } else if (all(rvUnixTime > 5e11 && rvUnixTime < 1.9e12)) {  //  05.11.1985 to 17.03.2030
          ssUnit = "ms"
     } else if (all(rvUnixTime > 5e14 && rvUnixTime < 1.9e15)) {  //  05.11.1985 to 17.03.2030
          ssUnit = "μs"
     }

.. us.comment

**Kommentar**

Berechnung der UniPlot Zeit::

     // days from 01.01.1900 to 01.01.1970: 25569 Days
     // Seconds in a day: 86400
     if (ssUnit == "s") {
          return rvUnixTime ./ 86400 + 25569;
     } else if (ssUnit == "ms") {
          return rvUnixTime ./ (86400 * 1e3) + 25569;
     } else if (ssUnit == "μs") {
          return rvUnixTime ./ (86400 * 1e6) + 25569;
     }

.. seealso::
   :ref:`uberblick-datum-und-zeit`,
   :ref:`DT_Format`,

:sub:`id-1580356`