# LGF_DTLtoString_ISO (FC / V3.0.1)

Autor: Siemens Digital Industry

## Kurzbeschreibung

Diese Funktion konvertiert ein Datum vom Datentyp DTL in eine Zeichenkette vom Datentyp STRING im internationalen Format (YYYY MM DD ...).

### Baustein Schnittstelle

| LGF_DTLtoString_ISO (FC) |
--- | --- | ---
DTL |  |  | date |  | Ret_Val |  |  | String
Char |  |  | separator |  |  |  |  |

### Input Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
date | DTL | Datum zum Konvertieren im Format DTL
separator | Char | Trennzeichen zwischen den Komponenten des ausgegebenen Datums.

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
Ret_Val | String | Ausgegebenen Zeichenkette entsprechend dem Format ISO 8601. Beispiel: `2019-01-22 14:06:51.524621000`.

## Funktionsbeschreibung

Der Baustein liest ein Datum vom Datentyp DTL ein und konvertiert die einzelnen Komponenten des Datums (Jahr, Monat, Tag, Stunde...) in eine Zeichenkette und gibt diese im internationalen Format aus. Das Trennzeichen zwischen den Komponenten des Datums ist variabel.

####### Internationales Format (ISO 8601):

####### Trennzeichen:

Am Eingangsparameter `separatorDate` geben Sie das Trennzeichen zwischen den Komponenten des Kalenderdatums vor.

####### Beispiel:

- separatorDate = `/` - outString = `2016/03/16…`
- separatorDate = `-` - outString = `2016-03-16…`

## Änderungshistorie

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 | Bugfix - nanosecond precision and '0' filling
| 01.00.05 | Simatic Systems Support
| 18.07.2019 | Renamed from "LGF_DTLtoString" to "LGF_DTLtoString_ISO" Split into two blocks, removed "format" input
| 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