diff --git a/fhem/FHEM/99_SUNRISE_EL.pm b/fhem/FHEM/99_SUNRISE_EL.pm
index ec11572e9..ce6dbe7b7 100644
--- a/fhem/FHEM/99_SUNRISE_EL.pm
+++ b/fhem/FHEM/99_SUNRISE_EL.pm
@@ -443,36 +443,39 @@ isday
alternatives.
sunrise() and sunset() return the absolute time of the next sunrise/sunset,
- adding 24 hours if the next event is tomorrow, to use it in the timespec of
- an at device or for the on-till command for FS20 devices.
-
+ adding 24 hours if the next event is tomorrow
sunrise_rel() and sunset_rel() return the relative time to the next
sunrise/sunset.
sunrise_abs() and sunset_abs() return the absolute time of the corresponding
event today (no 24 hours added).
sunrise_abs_dat() and sunset_abs_dat() return the absolute time of the
- corresponding event to a given date(no 24 hours added).
+ corresponding event to a given date.
- All functions take up to three arguments:
+ Note: use sunrise/sunset in the timespec of an at device or on-till
+ command as the _rel and _abs variants do not work correctly there.
+
+ All functions take up to four arguments:
- - The first specifies an offset (in seconds), which will be added to the
- event.
- - The second and third specify min and max values (format: "HH:MM").
+ - altitude (optional)
+ altitude defines a horizon value which then is used instead of the
+ $defaultaltit in SUNRISE_EL.pm.
Possible values are: "REAL",
+ "CIVIL", "NAUTIC", "ASTRONOMIC" or a positive or negative number
+ prefixed with "HORIZON="
+ REAL is 0, CIVIL is -6, NAUTIC is -12, ASTRONOMIC is -18 degrees above
+ horizon.
+
+ - time-offset in seconds, which will be added to the event.
+
+ - min and max values (format: "HH:MM").
+ If min < max, than the day starts not before min, and ends not after max.
+ If min > max, than the day starts not after max, and ends not before min.
+
isday() can be used in some notify or at commands to check if the sun is up
- or down. isday() ignores the seconds parameter, but respects min and max.
- If min < max, than the day starts not before min, and ends not after max.
- If min > max, than the day starts not after max, and ends not before min.
+ or down. isday() ignores the time-offset parameter, but respects min and max.
- Optionally, for all functions you can set first argument which defines a
- horizon value which then is used instead of the $defaultaltit in
- SUNRISE_EL.pm.
Possible values are: "REAL", "CIVIL", "NAUTIC",
- "ASTRONOMIC" or a positive or negative number preceded by "HORIZON="
REAL
- is 0, CIVIL is -6, NAUTIC is -12, ASTRONOMIC is -18 degrees above
- horizon.
-
Examples: