LGF_StringToDTL_DE (FC / V3.0.1)


Autor: Siemens Digital Industry

Kurzbeschreibung

Diese Funktion konvertiert eine Zeichenkette (String) im traditionellen Format (DE) mit Datumskomponenten in den Datentyp DTL.

Baustein Schnittstelle

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

Input Parameter

BezeichnerDatentypBeschreibung
dateStringDatum als Zeichenkette entsprechend dem Format.
Beispiel: `22-01-2019 14:07:57.696417000`.

Output Parameter

BezeichnerDatentypBeschreibung
Ret_ValDTLDas konvertierte Datum und die Zeit im Format DTL
errorBoolFALSE: Kein Fehler
TRUE: Während der Ausführung des FB ist ein Fehler aufgetreten
statusWord16#0000-16#7FFF: Status des FB
16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)

Status & Error Meldungen

Code / WertBezeichner / Beschreibung
16#0000STATUS_FINISHED_NO_ERROR
Status: Abarbeitung ohne Fehler beendet
16#7000STATUS_NO_CURRENT_JOBS
Status: Kein aktueller Auftrag in Bearbeitung
16#8201ERR_FORMAT_YEAR
Fehler: JAHR ausserhalb des Wertebereiches von DTL - Jahres Angabe entspricht nicht dem Format oder Angabe
16#8202ERR_FORMAT_MONTH
Fehler: MONAT ausserhalb des Wertebereiches von DTL - Monats Angabe entspricht nicht dem Format oder Angabe
16#8203ERR_FORMAT_DAY
Fehler: TAG ausserhalb des Wertebereiches von DTL - Tages Angabe entspricht nicht dem Format oder Angabe
16#8204ERR_FORMAT_HOUR
Fehler: STUNDE ausserhalb des Wertebereiches von DTL - Stunden Angabe entspricht nicht dem Format oder Angabe
16#8205ERR_FORMAT_MINUTE
Fehler: MINUTE ausserhalb des Wertebereiches von DTL - Minuten Angabe entspricht nicht dem Format oder Angabe
16#8206ERR_FORMAT_SECOND
Fehler: SEKUNDE ausserhalb des Wertebereiches von DTL - Sekunden Angabe entspricht nicht dem Format oder Angabe
16#8207ERR_FORMAT_NANOSECOND
Fehler: NANOSEKUNDE ausserhalb des Wertebereiches von DTL - Nanosekunden Angabe entspricht nicht dem Format oder Angabe

Funktionsbeschreibung

Der Baustein liest ein Datum als Zeichenkette ein und konvertiert dieses in den Datentyp DTL. Die einzelnen Datumskomponenten in der Zeichenkette werden entsprechend des traditionellen (DE) separiert. Dabei ist das Trenn-zeichen zwischen den Komponenten in der Zeichenkette irrelevant.

####### Traditionelles Format (DE):

LGF_DTLtoString_DE - Aufbau der Zeichenkette im traditionellem Format

Änderungshistorie

Version & DatumÄnderungsbeschreibung
01.00.00Simatic Systems Support
22.07.2019First released version
Split from "LGF_StringToDTL"
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