|
Type
| Function |
|
Description
| Converts an unsigned integer value into a binary coded decimal value (BCD value) of the data type BYTE.
The function is an overloaded function. It can operate on all unsigned input data types (UDINT, UINT, ULINT and USINT). |
|
Parameters
| Input
 IN
| Data type: | The function can process the UDINT, UINT, ULINT and USINT unsigned integer values at its input. |
Output
OUT
|
|
Conversion rules
|
In a BCD BYTE, integer values between 0 and 99 can be stored. Each digit is represented by four bits. If the input value has more than 2 digits (exceeds the maximum value of the BCD BYTE), the function returns the maximum value 16#FF.
|
|
Error behavior
| Error behavior
The following table shows the errors which may occur while executing the function and the value returned by the function in the corresponding error case.
| Error case | Output value |
| Overflow | LIMIT (maximum value) |
|
|
Examples
| Examples in ST
out := TO_BCD_BYTE(USINT#14); (* results in 16#14 *)
out := TO_BCD_BYTE(UINT#99); (* results in 16#99 *)
out := TO_BCD_BYTE(ULINT#100); (* results in 16#FF *)
|
|
Additional information
| EN/ENO behavior
The POU is only executed if TRUE is applied to the EN input. If EN = FALSE, the POU is not executed and ENO = FALSE indicates the inactivity.
If any of the errors listed under "Error behavior" occurs while executing the function, ENO is set to FALSE.
|