# LGF_DTLtoString_DE (FC / V3.0.1)

Author: Siemens Digital Industry

## Short description

This function converts a date of data type DTL into a character string of data type STRING in the traditional format (DD MM YYYYY…).

### Block Interface

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

### Input parameter

Identifier | Data type | Description
--- | --- | ---
date | DTL | Date to convert as DTL tag
separator | Char | Separator between the components of the output date.

### Output parameter

Identifier | Data type | Description
--- | --- | ---
Ret_Val | String | Output string according to the traditional format. Example: `22-01-2019 14:07:57.696417000`.

## Functional description

The block reads a date of data type DTL and converts the individual components of the date (year, month, day, hour…) into a character string and outputs it in traditional format (DE). The separator between the components of the date is variable.

####### Traditional format (DE):

####### Separator:

At the input parameter `separatorDate`, you specify the separator between the components of the calendar date.

####### Example:

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

## Change log

Version & Date | Change description
--- | ---
| 01.00.00 | Simatic Systems Support
| 18.07.2019 | First released version Split from "LGF_DTLtoString"
| 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