This page is available in: en

tk_set_tim

Set Time

[C Language Interface]

ER ercd = tk_set_tim ( SYSTIM *pk_tim ) ;

[Parameters]

SYSTIM* pk_tim Address of current time packet

pk_tim detail:

SYSTIM systim Current system time

[Return Parameters]

ER ercd Error code

[Error Codes]

E_OK Normal completion

E_PAR Parameter error (pk_tim is invalid, or time setting is invalid)

[Description]

Sets the system clock to the value specified in systim.

System time is expressed as cumulative milliseconds from 0:00:00 (GMT), January 1, 1985.

[Additional Notes]

The relative time specified in RELTIM or TMO does not change even if the system clock is changed by calling tk_set_tim during system operation. For example, if a timeout is set to elapse in 60 seconds and the system clock is advanced by 60 seconds by tk_set_tim while waiting for the timeout, the timeout occurs not immediately but 60 seconds after it was set. Instead, tk_set_tim changes the system time at which the timeout occurs.

Comments