/sun
/sun [location] [remember] [date_str]
Sunrise, sunset, day length, golden hour, and blue hour windows for a location — plus the Sun’s current altitude/azimuth, when checking today.
Usage: /sun location: Flagstaff, AZ for today, or add
date_str: 2026-09-22 to check a different date instead
(useful for planning a shoot ahead of time). Add
remember: True to also save the typed location as your new
default.
Golden hour (Sun between -4° and +6° altitude) and blue hour (Sun between -6° and -4°) are photography-community terms, not officially standardized astronomical ones like civil/nautical/astronomical twilight — real sources vary by a couple of degrees on the exact boundary. This command uses the pairing two independent sources agree on exactly, which also lines up with this bot’s own existing twilight thresholds. Each occurs twice a day (once around sunrise, once around sunset), so both windows are shown for each.
Current Sun position is only shown when checking today — it wouldn’t mean anything for a date that isn’t right now. Near the poles, some or all of these events may not occur on a given day at all (polar day or polar night); that’s reported plainly rather than shown as a broken or missing time.
Solstices and equinoxes aren’t covered here — they’re a standing, year-round fact rather than something that changes day to day, and are planned as their own separate command.
Parameters
| Name | Required | Description |
|---|---|---|
location | No | City name, decimal, or DMS coordinates. Leave blank to use your saved default. |
remember | No | Also save this as your new default location (otherwise this is a one-off lookup) |
date_str | No | Optional date to check instead of today, format YYYY-MM-DD (e.g. 2026-09-22) |