LGF_StringToDTL_ISO (FC / V3.0.1)

Overview

Author: Siemens Digital Industry

Short description

This function converts a character string in international format with date components into the data type DTL.

Block Interface

LGF_StringToDTL_ISO (FC)
String  date Ret_Val  DTL
    
   error  Bool
    
   status  Word
    
   

Input parameter

IdentifierData type Description
dateString Date as a character string according to the format.
Example: `22-01-2019 14:07:57.696417000`.

Output parameter

IdentifierData type Description
Ret_ValDTL The converted date and time in the format DTL
errorBool FALSE: No error
TRUE: An error occurred during the execution of the FB
statusWord 16#0000-16#7FFF: Status of the FB
16#8000-16#FFFF: Error identification (see following Table)

Status & Error codes

Code / ValueIdentifier / Description
16#0000STATUS_FINISHED_NO_ERROR
Status: Execution finished without errors
16#7000STATUS_NO_JOB
Status: No current job processed
16#8201ERR_FORMAT_YEAR
Error: YEAR out of range of DTL - YEAR value does not correspond to the format or specification (outside the value range of DTL)
16#8202ERR_FORMAT_MONTH
Error: MONTH out of range of DTL - MONTH value does not correspond to the format or specification (outside the value range of DTL)
16#8203ERR_FORMAT_DAY
Error: DAY out of range of DTL - DAY value does not correspond to the format or specification (outside the value range of DTL)
16#8204ERR_FORMAT_HOUR
Error: HOUR out of range of DTL - HOUR value does not correspond to the format or specification (outside the value range of DTL)
16#8205ERR_FORMAT_MINUTE
Error: MINUTE out of range of DTL - MINUTE value does not correspond to the format or specification (outside the value range of DTL)
16#8206ERR_FORMAT_SECOND
Error: SECOND out of range of DTL - SECOND value does not correspond to the format or specification (outside the value range of DTL)
16#8207ERR_FORMAT_NANOSECOND
Error: NANOSECOND out of range of DTL - NANOSECOND value does not correspond to the format or specification (outside the value range of DTL)

Functional description

The block reads a date as a character string and converts it to the data type DTL. The individual date components in the character string are separated according to the international format. The separator between the components in the character string is irrelevant.

####### International format (ISO 8601):

LGF_DTLtoString_ISO - Structure of the character string in accordance with ISO 8601

Change log

Version & DateChange description
01.00.00Siemens Industry Online Support
15.06.2016First released version
01.00.01Siemens Industry Online Support
02.01.2017Upgrade: TIA Portal V14 Update 1
01.00.02Siemens Industry Online Support
17.08.2018Upgrade: TIA V15 Update 2
01.00.03Siemens Industry Online Support
23.11.2018Upgrade: TIA V15.1
01.00.04Simatic Systems Support
17.07.2019Reworked from "LGF_StringToDTL" to "LGF_StringToDTL_ISO"
Removed format and split into two blocks
Bugfix - set weekday correctly
Correction of the weekday of DTL, comments added
Add ENO handling, adjust comments in interface
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