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

SPLIT_LDT

Type	Function
Description	Splits a date with time of day (LDATE_AND_TIME) 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_LDT(IN:LDATE_AND_TIME, YEAR=>ANY_INT, MONTH=>ANY_INT, DAY=>ANY_INT, 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 (YEAR, MONTH, DAY, etc.) have to be passed formal, i.e., the formal parameter name must be explicitly specified. Example: out := SPLIT_LDT(LDT#2016-11-14-16:31:04.120_100, YEAR=>yearVar, MONTH=>monthVar, DAY=>dayVar, HOUR=>hourVar, MINUTE=>minVar, SECOND=>secVar, MILLISECOND=>milVar, MICROSECOND=>micVar, NANOSECOND=>nanVar);   (* results in yearVar = 2016, monthVar = 11, 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: LDATE_AND_TIME Description: Date with 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.