GetDateAndTime
(FB)
FUNCTION_BLOCK GetDateAndTime
This function block reads the realtime clock.
It returns the time of the local time zone (i.e. a possible switch to summer/standard time will be regarded).
The current time zone switch can be defined by SetTimeZoneInformation.
If a switch to summer/standard time has become necessary since the last polling of the time, this is done automatically.
At the start of the module the outputs dtDateAndTime
and eTimezone
are reset. (DT#1970-01-01-00:00
and RTCLK_UNKNOWN
).
After successful operation they will contain the current local time.
- InOut:
Scope
Name
Type
Comment
Input
xExecute
BOOL
Rising edge: Action startFalling edge: Resets outputs. If a falling edge occurs before the function block has completed its Action, the outputs operate in the usual manner and are only reset if either the action is completed or in the event of an error. In this case, the corresponding output values (xDone, xError, iError) are present at the outputs for exactly one cycle.Output
xDone
BOOL
Action successfully completed
xBusy
BOOL
Function block active
xError
BOOL
TRUE
: error occurred, function block aborts actionFALSE
: no erroreError
Error description for diagnosis
dtDateAndTime
DT
Current local time
eTimezone
Current time zone