Solar Provider
The Solar Provider calculates sun rise, set and noon dates for a given location, date and timezone using the a modified NOAA Solar Calculator algorithm.
Configuration
-
GPS Location
This is normally the own location.
The location input comes normally from the Location or GPS provider.
Coordinates must be in Decimal degrees (DD) format likelatitude, longitude
, e.g.41.40338, 2.17403
. Decimal separator is a dot. -
Date
The date (and timezone) for the lunation (moon phase) cycle calculation.
The date must be an ISO formatted time likeyyyy-MM-dd’T’HH:mm:ssXX
with timezone info, e.g. from the Time provider, a date format ofyyyy-MM-dd
(using the local timezone) or leave it empty for the actual date. -
Result Timezone
he timezone for the calculated result times.
This is normally the timezone of the current location (System default).
Query
-
Status
Text Numeric Description N/A
0
Date or location is invalid
Excellent
1
Date and location are valid
-
Sunrise
Date and time of sunrise.Text Numeric Time in the format specified by Param 1
Milliseconds since 1970-01-01 00:00:00 UTC + Timezone
-
Param 1
The time format of the text representation. See Time Format for details.
If empty, the default ISO formatyyyy-MM-dd’T’HH:mm:ss.SSSxxx
is used.
-
-
Sunset
Date and time of sunset.Text Numeric Time in the format specified by Param 1
Milliseconds since 1970-01-01 00:00:00 UTC + Timezone
-
Param 1
The time format of the text representation. See Time Format for details.
If empty, the default ISO formatyyyy-MM-dd’T’HH:mm:ss.SSSxxx
is used.
-
-
Noon
Date and time of noon, the highest sun position of the day.Text
Numeric
Time in the format specified by Param 1
Milliseconds since 1970-01-01 00:00:00 UTC + Timezone
-
Param 1
The time format of the text representation. See Time Format for details.
If empty, the default ISO formatyyyy-MM-dd’T’HH:mm:ss.SSSxxx
is used.
-
-
Day Phase
The day phase as percentage from0
(sunrise) to100
(sunset).
It is0
before sunrise and100
after sunset. -
Is Day
1
if the local time is between sunrise and sunset,0
otherwise. -
Daytime
Return the duration of the day from sunrise to sunset.Text Numeric Daytime duration in the format specified by Param 1
Daytime duration in milliseconds
-
Param 1
Repeating a token sets the leading zeros, e.g.ss
gives04
for 4 seconds.
Available Pattern Tokens:Token Duration element S
Milliseconds
s
Seconds
m
Minutes
H
Hours
d
Days
w
Weeks
'text'
Text content
E.g. use "HH:mm" for an countdown
-
-
Nighttime
Return the duration of the night from sunset to sunrise of the next day.Text Numeric Nighttime duration in the format specified by Param 1
Nighttime duration in milliseconds
-
Param 1
Repeating a token sets the leading zeros, e.g.ss
gives04
for 4 seconds.
Available Pattern Tokens:Token Duration element S
Milliseconds
s
Seconds
m
Minutes
H
Hours
d
Days
w
Weeks
'text'
Text content
E.g. use "HH:mm" for an countdown
-
-
Next Time
Date and time of the next sunrise or sunset in relation to the actual time.Text
Numeric
Time in the format specified by Param 1
Milliseconds since 1970-01-01 00:00:00 UTC + Timezone
-
Param 1
The time format of the text representation. See Time Format for details.
If empty, the default ISO formatyyyy-MM-dd’T’HH:mm:ss.SSSxxx
is used.
-
-
Next Name
sunrise
(0
) orsunset
(1
) in relation to the actual time.