|
Type
| Function |
|
Description
| Concatenates (combines) the integer values (ANY_INT) for year, month, day, hour, minute, second, millisecond, microsecond and nanosecond to build a date with time of day. The result is stored to the output of the data type LDATE_AND_TIME.The function is an overloaded function. It can operate on all ANY_INT input data types. |
|
Parameters
| Inputs
 YEAR
| Data type: | ANY_INT |
| Permissible range: | 1 - 9999 |
MONTH
| Data type: | ANY_INT |
| Permissible range: | 1 - 12 |
DAY
| Data type: | ANY_INT |
| Permissible range: | 1 through the number of days in the MONTH. |
HOUR
| Data type: | ANY_INT |
| Permissible range: | 0 - 23 |
MINUTE
| Data type: | ANY_INT |
| Permissible range: | 0 - 59 |
SECOND
| Data type: | ANY_INT |
| Permissible range: | 0 - 59 |
MILLISECOND
| Data type: | ANY_INT |
| Permissible range: | 0 - 999 |
MICROSECOND
| Data type: | ANY_INT |
| Permissible range: | 0 - 999 |
NANOSECOND
| Data type: | ANY_INT |
| Permissible range: | 0 - 999 |
Output
OUT
| Data type: | LDATE_AND_TIME |
| Description: | Date and time |
|
|
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 |
| Input value (year, month, day etc.) out of permissible range | LDT#1970-01-01-00:00:00 |
| Invalid date for month (e.g. 30.02.2021, 31.04.2021) | LDT#1970-01-01-00:00:00 |
Resulted date outside min/max values
min: 1677-09-21-00:12:43.145224192
max: 2262-04-11-23:47:16.854775807 | Overflow value |
If one of the listed error occurs, the 'Argument out of range' error is written to the Online Log in the MESSAGES window.
|
|
Examples
| Example in ST
out := CONCAT_LDT(2016, 11, 14, 22, 55, 10, 882, 70, 223); (* results in LDT#2016-11-14-22:55:10.882 070 223 *) |
|
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.
|