# 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

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
date | String | Datum als Zeichenkette entsprechend dem Format. Beispiel: `22-01-2019 14:07:57.696417000`.

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
Ret_Val | DTL | Das konvertierte Datum und die Zeit im Format DTL
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_FINISHED_NO_ERROR Status: Abarbeitung ohne Fehler beendet
16#7000 | STATUS_NO_CURRENT_JOBS Status: Kein aktueller Auftrag in Bearbeitung
16#8201 | ERR_FORMAT_YEAR Fehler: JAHR ausserhalb des Wertebereiches von DTL - Jahres Angabe entspricht nicht dem Format oder Angabe
16#8202 | ERR_FORMAT_MONTH Fehler: MONAT ausserhalb des Wertebereiches von DTL - Monats Angabe entspricht nicht dem Format oder Angabe
16#8203 | ERR_FORMAT_DAY Fehler: TAG ausserhalb des Wertebereiches von DTL - Tages Angabe entspricht nicht dem Format oder Angabe
16#8204 | ERR_FORMAT_HOUR Fehler: STUNDE ausserhalb des Wertebereiches von DTL - Stunden Angabe entspricht nicht dem Format oder Angabe
16#8205 | ERR_FORMAT_MINUTE Fehler: MINUTE ausserhalb des Wertebereiches von DTL - Minuten Angabe entspricht nicht dem Format oder Angabe
16#8206 | ERR_FORMAT_SECOND Fehler: SEKUNDE ausserhalb des Wertebereiches von DTL - Sekunden Angabe entspricht nicht dem Format oder Angabe
16#8207 | ERR_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):

## Änderungshistorie

Version & Datum | Änderungsbeschreibung
--- | ---
| 01.00.00 | Simatic Systems Support
| 22.07.2019 | First released version Split from "LGF_StringToDTL" Correction of the weekday of DTL, comments added Add ENO handling, adjust comments in interface
| 03.00.00 | Simatic Systems Support
| 23.04.2020 | Set version to V3.0.0 Harmonize the version of the whole library
| 03.00.01 | Simatic Systems Support
| 23.02.2021 | Insert documentation