diff --git a/reference/datetime/functions/date-sun-info.xml b/reference/datetime/functions/date-sun-info.xml index f3234dbefc..41cb40d0ff 100644 --- a/reference/datetime/functions/date-sun-info.xml +++ b/reference/datetime/functions/date-sun-info.xml @@ -51,6 +51,90 @@ &reftitle.returnvalues; Returns array on success&return.falseforfailure;. + The structure of the array is detailed in the following list: + + + + + sunrise + + + The time of the sunrise. + + + + + sunset + + + The time of the sunset. + + + + + transit + + + The time when the sun is at its zenith, i.e. has reached its topmost + point. + + + + + civil_twilight_begin + + + The start of the civil dawn. It ends at sunrise. + + + + + civil_twilight_end + + + The end of the civil dusk. It starts at sunset. + + + + + nautical_twilight_begin + + + The start of the nautical dawn. It ends at + civil_twilight_begin. + + + + + nautical_twilight_end + + + The end of the nautical dusk. It starts at + civil_twilight_end. + + + + + astronomical_twilight_begin + + + The start of the astronomical dawn. It ends at + nautical_twilight_begin. + + + + + astronomical_twilight_end + + + The end of the astronomical dusk. It starts at + nautical_twilight_end. + + + + + + The values of the array elements are either UNIX timestamps, &false; if the sun is below the respective zenith for the whole day, or &true; if the sun is above the respective zenith for the whole day.