TIME_DINT_TO_STRING: Conversion of a variable to DINT format

Function description

The function TIME_DINT_TO_STRING is used to convert a variable in format (TIME using PL7) into a character string.

The additional parameters and can be configured.

Representation in FBD

Representation:

Representation in LD

Representation:

Representation in IL

Representation:

LD Time1

TIME_DINT_TO_STRING

ST Result_Str

Representation in ST

Representation:

Result_Str := TIME_DINT_TO_STRING(Time1);

Description of parameters

The following table describes the input parameters:

Parameter	Type	Comment
Time1	DINT	Duration to convert into character string format.

The following table describes the output parameters:

Parameter	Type	Comment
Result_Str	String	Result_Str is a string of 15 characters containing a duration in the following format: HHHHHH:MM:SS.D. Example: ’119304:38:49.5’

Runtime errors

If the string Result_Str is too short to contain the date (length = less than 15 characters), the date is truncated and the bit %S15 is set to 1.

EN stands for ENable; it is an optional block input. When the EN input is enabled, an ENO output is set automatically.

If EN = 0, the block is not enabled; its internal program is not executed, and ENO is set to 0.

If EN = 1, the block's internal program is run and ENO is set to 1. If an error occurs, ENO is set to 0.

If the EN input is not connected, it is set automatically to 1.

ENO

ENO stands for Error NOtification; this is the output associated with the optional input EN.

If ENO is set to 0 (because EN = 0 or in case of an execution error):

the status of the function block outputs remains the same as it was during the previous scanning cycle that executed correctly;
the output(s) of the function, as well as the procedures, are set to "0".

DATE

The DATE type, encoded in BCD in a 32 bit format, contains the following information:

The DATE type must be entered as follows: D#<Year>-<Month>-<Day>

This table shows the upper/lower limits of each field:

Field	Limits	Comment
Year	[1990,2099]	Year
Month	[01,12]	The leading 0 is displayed; it can be omitted during data entry.
Day	[01,31]	For months 01/03/05/07/08/10/12
	[01,30]	For months 04/06/09/11
	[01,29]	For month 02 (leap years)
	[01,28]	For month 02 (non-leap years)