DTU.GetDateAndTime (FB prefix: gdt)

This function block of the CAA_DTUtil.library 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 „DTU.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.

Input:

xExecute

BOOL

A rising edge will start the action

see: Guidelines for CAA libs

Output:

dtDateAndTime

DATE_AND_TIME

Current local time

eTimeZone

RTCLK_PERIODE

Current time zone

xDone

BOOL

Action terminated successfully

see: Guidelines for CAA libs

xBusy

BOOL

Module active

see: Guidelines for CAA libs

xError

BOOL

Error occurred

see: Guidelines for CAA libs

eError

WORD

Error ID for diagnosis

(see DTU.ERROR)