DTSetDateTime

Function Block A function block groups an algorithm and a set of private data. It has inputs and outputs. - Sets the local date and time.

This function A function calculates a result according to the current value of its inputs. A function has no internal data and is not linked to declared instances. block is specific for PCMM2G only.

Inputs

If the UTC time needs to be set, change the time zone to UTC using DTSetTimeZone, set the time, then restore the time zone.

Input	Data Type	Range	Unit	Default	Description
Execute	BOOL	TRUE, FALSE	N/A	No default	If TRUE, request to set the local date and time.
Year	DINT	1900 to 2200	Year	No default	The local date’s new value of the year.
Month	DINT	1 to 12	Month	No default	The local date’s new value of the month.
Day	DINT	1 to 31	Day	No default	The local date’s new value of the day.
Hour	DINT	0 to 23	Hour	No default	The local date’s new value of the hour.
Min	DINT	0 to 59	Minute	No default	The local date’s new value of the minute.
Sec	DINT	0 to 60	Second	No default	The local date’s new value of the second. 60 is valid because leap seconds may have a value of 60.

Outputs

Output	Data Type	Range	Unit	Description
Done	BOOL	TRUE, FALSE	N/A	If TRUE, the command completed successfully.
Error	BOOL	TRUE, FALSE	N/A	If TRUE, an error has occurred.
ErrorID	DINT	No range	N/A	Indicates the error if the Error output is set to TRUE. Error Codes 23 = Internal error. See the controller log for details. 15000 = Controller type does not support this function block. 16202 = Cannot set date / time when NTP synchronization Combines an axis or axes group (as slave) with an axis as master. The slave executes its path with synchronization to the progress of the master. This is linked to a one dimension source for synchronization. is active. 16203 = Invalid date / time value specified.

Output

Data Type

Range

Unit

Description

Done

BOOL

TRUE, FALSE

N/A

If TRUE, the command completed successfully.

Error

BOOL

TRUE, FALSE

N/A

If TRUE, an error has occurred.

ErrorID

DINT

No range

N/A

Indicates the error if the Error output is set to TRUE.

Error Codes

23 = Internal error.
See the controller log for details.
15000 = Controller type does not support this function block.
16202 = Cannot set date / time when NTP synchronization Combines an axis or axes group (as slave) with an axis as master. The slave executes its path with synchronization to the progress of the master. This is linked to a one dimension source for synchronization. is active.
16203 = Invalid date / time value specified.

Remarks

None

FBD Language Example

FFLD Language Example

IL Language Example

Not available.

ST Language Example

// write the date and time
Inst_DTSetDateTime( bSetDateTime, Year, Month, Day, Hour, Minute, Second );
if Inst_DTSetDateTime.Done then
   bSetDateTime := false;

   bError := Inst_DTSetDateTime.Error;
   ErrorID := Inst_DTSetDateTime.ErrorID;
end_if;