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

SPLIT_LTIME

Type	Function
Description	Splits a duration (LTIME) and returns the split values (ANY_INT) for 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_LTIME(IN:LTIME, DAYS=>ANY_INT, HOURS=>ANY_INT, MINUTES=>ANY_INT, SECONDS=>ANY_INT, MILLISECONDS=>ANY_INT, MICROSECONDS=>ANY_INT, NANOSECONDS=>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 (DAYS, HOURS, MINUTES, etc.) have to be passed formal, i.e., the formal parameter name must be explicitly specified. Example: out := SPLIT_LTIME(LT#14d16h31m4.120_099_100s, DAYS=>dayVar, HOURS=>hourVar, MINUTES=>minVar, SECONDS=>secVar, MILLISECONDS=>milVar, MICROSECONDS=>micVar, NANOSECONDS=>nanVar);   (* results in dayVar=14, hourVar = 16, minVar = 31, secVar = 4, milVar = 120, micVar = 99, nanVar = 100 *) 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: TIME Description: Time of day Outputs DAYS, HOURS, MINUTES, SECONDS, MILLISECONDS, MICROSECONDS, NANOSECONDS 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 MILLISECONDS 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.