F_EuropeanLocalTime

Die Funktion konvertiert die UTC-Zeit (structured system time format) in Lokalzeit (structured system time format) unter der Berücksichtigung der angegebenen Offset-Information. Die Funktion darf nur innerhalb Europas verwendet werden und ist nicht für jede beliebige Zeitzone der Welt gültig.

Der Funktionsbaustein FB_SystemTimeToTzSpecificLocalTime besitzt eine ähnliche Funktionalität, mit dem Unterschied, dass er weltweit verwendet werden kann. F_EuropeanLocalTime bietet für Anwendungen innerhalb von Europa den Vorteil, dass die Abarbeitungszeit kürzer ist und sich die Funktion insofern insbesondere für kleine Steuerungen anbietet.

Die Funktion liefert neben der Lokalzeit die Information, ob es sich um Sommerzeit (Daylight Saving Time) oder Winterzeit (Standard Time) handelt. Anhand der Zeitzoneninformation bzw. dem Offset errechnet der Funktionsbaustein die erforderlichen Zeitsprünge in der Lokalzeit (Sommer-/Winterzeit-Umstellung).

VAR_INPUT
    UTC        : TIMESTRUCT;
    UTC_Offset : INT;
END_VAR

VAR_OUTPUT
    bDaylightSavingTime   : BOOL;
END_VAR

PROGRAM MAIN
VAR
    in    : TIMESTRUCT := ( wYear := 2011, wMonth := 4, wDay := 29, wHour := 14, wMinute := 46, wSecond := 31, wMilliseconds := 99 );(* UTC time *)
    out   : TIMESTRUCT; (* Local time result is:= ( wYear := 2011, wMonth := 4, wDay := 29, wHour := 16, wMinute := 46, wSecond := 31, wMilliseconds := 99 ) *)
    bSummerTime : BOOL;
END_VAR

out := F_EuropeanLocalTime( UTC := in, UTC_Offset := 60 (*Germany*), bDaylightSavingTime => bSummerTime );