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

SPLIT_LDATE

Type	Function
Description	Splits a date (LDATE) and returns the split values (ANY_INT) for year, month, and day at the outputs.
Function call	Function call in ST In ST, the function is called as follows: out := SPLIT_LDATE(IN:LDATE, YEAR=>ANY_INT, MONTH=>ANY_INT, DAY=>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). The output parameters YEAR, MONTH, and DAY have to be passed formal, i.e., the formal parameter name must be explicitly specified. Example: out := SPLIT_LDATE(LDATE#2016-11-14, YEAR=>myYearVar, MONTH=>myMonthVar, DAY=>myDayVar);   (* results in myYearVar = 2016, myMonthVar = 11, myDayVar = 14 *) 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 Description: Date Outputs YEAR, MONTH, DAY 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.