LGF_DTLToUnixTime (FC / V3.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

BezeichnerDatentyp Beschreibung
timeDTLDTL Datum und Uhrzeit als DTL zur Konvertierung nach UNIX Zeit

Output Parameter

BezeichnerDatentyp Beschreibung
Ret_ValDInt Konvertierte UNIX Zeit
errorBool FALSE: Kein Fehler
TRUE: Während der Ausführung des FB ist ein Fehler aufgetreten
statusWord 16#0000-16#7FFF: Status des FB
16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)

Status & Error Meldungen

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

Änderungshistorie

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