LGF_UnixTimeToDTL (FC / V3.0.1)


Author: Siemens Digital Industry

Short description

This function converts the Unix time of data type DInt to a date and time of data type DTL. The timestamp is calculated in UTC. This means that the time zone is not considered.

Only times after 01/01/1990 are permitted.

Block Interface

LGF_UnixTimeToDTL (FC)
DInt  timeUnix Ret_Val  DTL
    
   error  Bool
    
   status  Word
    
   

Input parameter

IdentifierData typeDescription
timeUnixDIntUNIX time to convert

Output parameter

IdentifierData typeDescription
Ret_ValDTLConverted time (Date and time).
In case of Error: 0 (error = true)
errorBoolFALSE: No error
TRUE: An error occurred during the execution of the FB
statusWord16#0000-16#7FFF: Status of the FB
16#8000-16#FFFF: Error identification (see following Table)

Status & Error codes

Code / ValueIdentifier / Description
16#0000STATUS_NO_ERRROR
Status: Execution finished without errors
16#6001WARN_CONVERSION_LIMIT
Warning: UNIX time (timeUnix) is exactly at the lower limit of 01.01.1990.
16#8000ERR_TIME_BEFORE_1990
Error: UNIX time (timeUnix) is before 01/01/1990. The function does not support this conversion.

Change log

Version & DateChange description
01.00.00Siemens Industry Online Support
16.10.2018First released version
01.00.01Simatic Systems Support
18.06.2019Standard header and block parameters update, status parameter added
01.00.02Simatic Systems Support
10.07.2019Commends added and code intention adjusted
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