# LGF_DTLToUnixTime (FC / 3.0.2)

Übersicht

Autor: Siemens Digital Industry

## Kurzbeschreibung

Diese Funktion konvertiert Datum und Uhrzeit vom Datentyp DTL in die UNIX Zeit vom Datentyp DInt. Der Zeitstempel wird in UTC gerechnet. Das bedeutet, dass die Zeitzone nicht berücksichtigt wird.

Es sind nur Zeiten ab dem 01.01.1990 zulässig.

### Baustein Schnittstelle

| LGF_DTLToUnixTime (FC) |
--- | --- | ---
DTL |  |  | timeDTL |  | Ret_Val |  |  | DInt
|  |  |  |  | error |  |  | Bool
|  |  |  |  | status |  |  | Word

### Input Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
timeDTL | DTL | Datum und Uhrzeit als DTL zur Konvertierung nach UNIX Zeit

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
Ret_Val | DInt | Konvertierte UNIX Zeit
error | Bool | FALSE: Kein Fehler TRUE: Während der Ausführung des FB ist ein Fehler aufgetreten
status | Word | 16#0000-16#7FFF: Status des FB 16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)

### Status & Error Meldungen

Code / Wert | Bezeichner / Beschreibung
--- | ---
16#0000 | STATUS_EXECUTION_FINISHED_NO_ERROR Abarbeitung ohne Fehler beendet
16#8000 | ERR_TIME_BEFORE_1990 Fehler: Eingangs Zeitstempel liegt vor 01.01.1990. Die Funktion unterstützt die Konvertierung nicht, aufgrund von intern verwendeten Datentypen.
16#8001 | ERR_DTL_INPUT_VALUE_INVALID Fehler: Eingangs Zeitstempel Wert nicht valide. Der Datentype enthält unplausible Daten.

## Änderungshistorie

Version & Datum | Änderungsbeschreibung
--- | ---
| 1.0.0 | Siemens Industry Online Support
| 16.10.2018 | First released version
| 1.0.1 | Simatic Systems Support
| 20.06.2019 | Standard header and block parameters update, status parameter added
| 1.0.2 | Simatic Systems Support
| 10.07.2019 | Commends added and code refactoring Add ENO handling
| 3.0.0 | Simatic Systems Support
| 23.04.2020 | Set version to V3.0.0 Harmonize the version of the whole library
| 3.0.1 | Simatic Systems Support
| 23.02.2021 | Insert documentation
| 3.0.2 | Simatic Systems Support
| 14.04.2023 | Improve data verification for input `timeDTL` for valid data