Diese Funktion konvertiert eine Zeichenkette (String) im internationalen Format mit Datumskomponenten in den Datentyp DTL.
| LGF_StringToDTL_ISO (FC) | ||||||||
|---|---|---|---|---|---|---|---|---|
| String | date | Ret_Val | DTL | |||||
| error | Bool | |||||||
| status | Word | |||||||
| Bezeichner | Datentyp | Beschreibung |
|---|---|---|
| date | String | Datum als Zeichenkette entsprechend dem Format. Beispiel: `22-01-2019 14:07:57.696417000`. |
| 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) |
| Code / Wert | Bezeichner / Beschreibung |
|---|---|
| 16#0000 | STATUS_FINISHED_NO_ERROR Status: Abarbeitung ohne Fehler beendet |
| 16#7000 | STATUS_NO_JOB 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 |
Der Baustein liest ein Datum als Zeichenkette ein und konvertiert dieses in den Datentyp DTL. Die einzelnen Datumskomponenten in der Zeichenkette werden entsprechend dem internationalen Format separiert. Dabei ist das Trennzeichen zwischen den Komponenten in der Zeichenkette irrelevant.
####### Internationales Format (ISO 8601):
| Version & Datum | Änderungsbeschreibung | |
|---|---|---|
| 01.00.00 | Siemens Industry Online Support | |
| 15.06.2016 | First released version | |
| 01.00.01 | Siemens Industry Online Support | |
| 02.01.2017 | Upgrade: TIA Portal V14 Update 1 | |
| 01.00.02 | Siemens Industry Online Support | |
| 17.08.2018 | Upgrade: TIA V15 Update 2 | |
| 01.00.03 | Siemens Industry Online Support | |
| 23.11.2018 | Upgrade: TIA V15.1 | |
| 01.00.04 | Simatic Systems Support | |
| 17.07.2019 | Reworked 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.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 | |