System time setting
Function name
SETSYSTEMTIME
ST call
PROGRAM TEST_SETSYSTEMTIME VAR system_time : dt; utc : bool; set_time : bool; END_VAR IF set_time THEN setsystemtime(system_time, UTC); set_time := FALSE; END_IF; END_PROGRAM
Description
The function sets the PLC system time to the requested value. It is used for controlled synchronisation of the internal PLC clock (RTC).
Inputs
| Input | Type | Description |
| systemTime | DT | Time to be set |
| utc | BOOL | Enable time zone (If UTC = „false“, the value at the systemTime input is considered as local time according to the time zone defined in the PLC. If UTC = „true“, the UTC time is set) |
Outputs
| Output | Type | Description |
| ⇒ | INT | value; result of time setting |
Function
The setsystemtime function sets the PLC system time according to input variable systemTime. The input variable UTC changes between local time and UTC time. The function output ⇒ returns the result of the setting process.
| Value | Description |
| 0 | Time was not set |
| 1 | Time was set successfully |