# LGF_UnixTimeToDTL (FC / 3.0.1)

Übersicht

Autor: Siemens Digital Industry

## Kurzbeschreibung

Diese Funktion konvertiert eine UNIX Zeit vom Datentyp DInt in Datum und Uhrzeit vom Datentyp DTL. 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_UnixTimeToDTL (FC) |
--- | --- | ---
DInt |  |  | timeUnix |  | Ret_Val |  |  | DTL
|  |  |  |  | error |  |  | Bool
|  |  |  |  | status |  |  | Word

### Input Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
timeUnix | DInt | Zu konvertierende UNIX Zeit

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
Ret_Val | DTL | Konvertierte Zeit (Datum und Uhrzeit). Im Fehlerfall: 0 (error = TRUE)
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_NO_ERRROR Status: Abarbeitung ohne Fehler beendet
16#6001 | WARN_CONVERSION_LIMIT Warnung: UNIX Zeit (timeUnix) liegt genau an der unteren Begrenzung vom 01.01.1990.
16#8000 | ERR_TIME_BEFORE_1990 Fehler: UNIX Zeit (timeUnix) liegt vor dem 01.01.1990. Das wird nicht von der Funktion unterstützt

## Änderungshistorie

Version & Datum | Änderungsbeschreibung
--- | ---
| 1.0.0 | Siemens Industry Online Support
| 16.10.2018 | First released version
| 1.0.1 | Simatic Systems Support
| 18.06.2019 | Standard header and block parameters update, status parameter added
| 1.0.2 | Simatic Systems Support
| 10.07.2019 | Commends added and code intention adjusted 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