# LGF_DTLToString_ISO (FC / 3.1.1)

Übersicht

Autor: Siemens Digital Industry

## Kurzbeschreibung

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

### Baustein Schnittstelle

| LGF_DTLToString_ISO (FC) |
--- | --- | ---
DTL |  |  | date |  | Ret_Val |  |  | String
Char |  |  | separator |  |  |  |  |
Char |  |  | separatorDateAndTime |  |  |  |  |

### Input Parameter

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

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
Ret_Val | String | Ausgegebenen Zeichenkette entsprechend dem internationalen 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 (ISO 8601) aus. Das Trennzeichen zwischen den Komponenten des Datums ist variabel.

### Internationales Format (ISO 8601):

### Trennzeichen:

Am Eingangsparameter `separator` geben Sie das Trennzeichen zwischen den Komponenten des Datums an, bei `seperatorDateAndTime` geben Sie das Trennzeichen zwischen Datum und Uhrzeit an.

### Beispiel:

- separator = `-` - outString = `2016-03-16…` (default)

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

- separatorDateAndTime = `` - outString = `2016-03-16 12:45…` (default)

- separatorDateAndTime = `T` - outString = `2016/03/16T12:45…`

## Änderungshistorie

Version & Datum | Änderungsbeschreibung
--- | ---
| 1.0.0 | Siemens Industry Online Support
| 15.06.2016 | First released version
| 1.0.1 | Siemens Industry Online Support
| 02.01.2017 | Upgrade: TIA Portal V14 Update 1
| 1.0.2 | Siemens Industry Online Support
| 17.08.2018 | Upgrade: TIA V15 Update 2
| 1.0.3 | Siemens Industry Online Support
| 23.11.2018 | Upgrade: TIA V15.1
| 1.0.4 | Simatic Systems Support
| 17.07.2019 | Bugfix - nanosecond precision and '0' filling
| 1.0.5 | Simatic Systems Support
| 18.07.2019 | Renamed from "LGF_DTLtoString" to "LGF_DTLToString_ISO" Split into two blocks, removed "format" input
| 3.0.0 | Simatic Systems Support
| 23.04.2020 | Set version to V3.0.0 Harmonize the version of the whole library
| 3.0.1 | Simatic Systems Support
| 23.02.2021 | Insert documentation
| 3.1.0 | Simatic Systems Support
| 25.07.2025 | Insert parameter for separator between Data and time Assign default value '-' for separator parameter
| 3.1.1 | Simatic Systems Support
| 09.10.2025 | Spelling errors