TOD_DINT_TO_STRING: Conversion of a variable to TOD format

Function description

The function TOD_DINT_TO_STRING is used to convert a format PL7 variable, or double integer, 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

TOD_DINT_TO_STRING

ST Result_Str

Representation in ST

Representation:

Result_Str := TOD_DINT_TO_STRING(Time1);

Description of parameters

The following table describes the input parameters:

Parameter	Type	Comment
Time1	DINT	PL7 time of day 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 8 characters containing a time of day in the following format: HH:MM:SS. Example: ’04:38:49’

Runtime errors

If the string Result_Str is too short to contain the converted value (length = less than 8 characters), it 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".

TOD

TOD is the abbreviation of Time Of Day.

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

NOTE: The 8 least significant bits are not used.

The TOD type must be entered as follows: TOD#<Hour>:<Minutes>:<Seconds>

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

Field	Limits	Comment
Hour	[00,23]	The leading 0 is displayed; it can be omitted during data entry.
Minute	[00,59]	The leading 0 is displayed; it can be omitted during data entry.
Second	[00,59]	The leading 0 is displayed; it can be omitted during data entry.

Example: TOD#23:59:45.