System time setting
- Function name
- ST call
- Description
- Inputs
- Outputs
- Function

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

Table of Contents