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
The structure ST_SPA_TIMESTRUCT contains information on date and time. It is used at the input for function block FB_SPA in order to specify the local time at the location. This local time has seconds as the smallest unit.
Various time scales are in use. The Universal Time (UT1) is used for sun position calculations based on the time specified in ST_SPA_TIMESTRUCT. If an inaccuracy of +/-0.005° is acceptable for the sun angles, the coordinated world time (UTC) may be used as the time. Explanatory notes can be found on the overview page.
Note: Summer and winter time clock change must not be used. The initiation of summer time (daylight saving time) in the 20.century should only extend the usable number of hours daylight per day. It's not common practice in all countries. For calculating the sun position with this library the Standard Time has to be used. In germany the Standard Time is equal to the winter time.