• Home
• Function/Function Block Reference
• IEC 61131-3 Functions and Function Blocks
• Data Type Conversion
• SPLIT_LTOD

SPLIT_LTOD

Type	Function
Description	Splits a time of day (LTIME_OF_DAY) and returns the split values (ANY_INT) for year, month, day, hour, minute, second, millisecond, microsecond, and nanosecond at the outputs.
Function call	Function call in ST In ST, the function is called as follows: out := SPLIT_LTOD(IN:LTIME_OF_DAY, HOUR=>ANY_INT, MINUTE=>ANY_INT, SECOND=>ANY_INT, MILLISECOND=>ANY_INT, MICROSECOND=>ANY_INT, NANOSECOND=>ANY_INT); All parameters have to be specified in the exact order. The IN parameter has to be passed non-formal (without specification of the formal parameter name). All output parameters (HOUR, MINUTE, SECOND, etc.) have to be passed formal, i.e., the formal parameter name must be explicitly specified. Example: out := SPLIT_LTOD(LTOD#23:01:55.500_660_01, HOUR=>hourVar, MINUTE=>minVar, SECOND=>secVar, MILLISECOND=>milVar, MICROSECOND=>micVar, NANOSECOND=>nanVar);   (* results in hourVar = 23, minVar = 1, secVar = 55, milVar = 500, micVar = 660, nanVar = 10 *) Function call in LD All outputs must be connected. The bool output pin is without function (will be removed in later version).
Parameters	Input IN Data type: LTIME_OF_DAY Description: Time of day Outputs YEAR, MONTH, DAY, HOUR, MINUTE, SECOND, MILLISECOND, MICROSECOND, NANOSECOND Data type: ANY_INT Bool output Data type: BOOL Description: Without function. Output will be removed in later version.
Error behavior	An overflow occurs if a smaller datatype as expected is connected to one of the ANY_INT outputs, e.g., SINT datatype on YEAR output.
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 an overflow on the ANY_INT outputs occurs (see "Error behavior" above) while executing the function, ENO is reset to FALSE. Further Info See the topic "General information on execution control with EN/ENO" for further details.