Get sun timesGet every sun and moon event for a place on one day: sunrise, sunset, solar noon, day length, the three twilights, the golden and blue hours, where the sun sits in the sky, and the moon's rise, set, phase and illumination. Times come back in the location's own timezone.
Get sun times for a date rangeGet sun and moon events for every day in a date range, up to 366 days in a single request: the right way to build a calendar, chart daylight across a year, or find a solstice. The longest and shortest day of the range are picked out alongside the full list.
Get golden hourGet the golden hour and blue hour windows for a place on one day (morning and evening), each with the minutes it lasts. The golden hour is the warm light just after sunrise and before sunset; the blue hour is the deep-blue sky either side of it. Neither is really an hour: the length is worked out for the day and place you ask about.
Get twilight timesGet dawn, dusk and the three twilights for a place on one day, grouped into the morning and evening runs they belong to: first light, then nautical, then civil twilight, then sunrise, and back out the other way after sunset. Civil twilight is when it is light enough to be outdoors without a lamp; after astronomical twilight the sky is fully dark.
Get moon timesGet the moon for a place on one day: when it rises and sets, its phase by name, and how much of it looks lit, as a percentage. About one day a month the moon does not rise, and another it does not set, within the local day; the response says which, rather than leaving a blank time unexplained.
Get solar positionGet where the sun rises, sets and stands at midday for a place on one day. Each bearing comes as degrees from north and as the compass direction it points to, and the noon altitude says how high the sun climbs: what you need to aim a camera, place a solar panel, or work out which windows get the light.
Get day lengthGet how long the day is at a place, and how that compares with the day before: the seconds gained or lost, and whether the days are lengthening or shortening. Use it to track the turn of the seasons, or to send a note when the evenings start drawing in.
Get current sun phaseFind out where the sun is at this moment at a place: whether it is daylight, twilight or night, whether the golden or blue hour is running, and which event is due next and in how many minutes. This is the check to branch a schedule on; switch something on at dusk, or send a reminder half an hour before sunset.
