Find sun times
find_sun_timesRead-only
Use this when the user asks for a golden hour calculator, golden hour time, sunrise sunset times, sunset time today, what time is golden hour, blue hour, sunrise time, or twilight times for a city and local date. Returns local sunrise, sunset, solar noon, day length, twilight, light windows and sun azimuth. Limits: cities with population 50,000+ (plus Tromso), dates 1900–2100, flat sea-level horizon; Does not model weather or terrain.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | Yes | City name, for example New York. Cities with population 50,000+ are supported; the largest same-name match is used. | |
| date | Yes | Local calendar date, YYYY-MM-DD, from 1900 to 2100; for example 2026-06-21. | |
| state | No | Optional US state name or abbreviation, for example NY or New York. | |
| country | No | Optional country name or two-letter code to narrow the match, for example US. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| blue | No | ||
| date | No | ||
| days | No | ||
| mode | Yes | ||
| civil | No | ||
| golden | No | ||
| period | No | ||
| sunset | No | ||
| values | No | ||
| changes | No | ||
| preview | No | ||
| request | Yes | ||
| sunrise | No | ||
| location | Yes | ||
| nautical | No | ||
| timeZone | No | ||
| dayLength | No | ||
| dayStatus | No | ||
| downloads | No | ||
| solarNoon | No | ||
| startDate | No | ||
| eventCount | No | ||
| definitions | Yes | ||
| limitations | Yes | ||
| astronomical | No | ||
| sunsetAzimuth | No | ||
| sunriseAzimuth | No | ||
| dayLengthSeconds | No |