ST_SPA_TIMESTRUCT

TYPE ST_SPA_TIMESTRUCT :
STRUCT
    iYear       :INT(-2000..6000);      (* 4-digit year, valid range: -2000 TO 6000, error code: 1      *)
    iMonth      :INT(1..12);    (* 2-digit month, valid range: 1 to 12 (Jan.= 1), error code: 2 *)
    iDay        :INT(1..31);    (* 2-digit day, valid range: 1 to 31, error code: 3         *)
    iHour       :INT(0..24);    (* Observer local hour, valid range: 0 to 24, error code: 4     *)
    iMinute     :INT(0..59);    (* Observer local minute, valid range: 0 to 59, error code: 5   *)
    iSecond     :INT(0..59);    (* Observer local second, valid range: 0 TO 59, error code: 6   *)
END_STRUCT
END_TYPE

Die Struktur ST_SPA_TIMESTRUCT enthält Informationen zum Datum und zur Zeit. Sie wird am Eingang des Funktionsbausteins FB_SPA genutzt, um die lokale Zeit des Standortes anzugeben. Diese Ortszeit hat als kleinste Einheit Sekunden.

Es existieren unterschiedliche Zeitskalen auf unserer Erde. Bei der Zeitangabe in ST_SPA_TIMESTRUCT zur Sonnenstandsberechnung wird die Universal Time (UT1) verwendet. Sofern eine Ungenauigkeit von +/-0,005 ° der Sonnenstandswinkel akzeptabel ist, kann auch die koordinierte Weltzeit (UTC) für die Zeitangabe verwendet werden. Erläuterungen hierzu finden sich auf der Übersichtsseite. 

Bei der Zeitangabe muss auf die Sommer-/Winterzeit Umstellung verzichtet werden. Die Einführung der Sommerzeit im 20.Jahrhundert dient nur dem Zweck, die Stundenzahl mit nutzbarem Tageslicht zu vergrößern. Zur Berechnung der Sonnenstandswinkel mit dieser Bibliothek muss die Normalzeit (engl.'Standard Time') verwendet werden. Die Normalzeit entspricht in Deutschland der Winterzeit.