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 start

Falling 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 action

FALSE: no error

eError

ERROR

Error description for diagnosis

dtDateAndTime

DT

Current local time

eTimezone

PERIODE

Current time zone