astronomy/sun

Sunrise, sunset, solar noon, twilight, and day length for a location and date.

Free / no pricing configured

What it does

Returns the dawn (civil twilight start), sunrise, solar noon, sunset, and dusk (civil twilight end) for a latitude/longitude on a given date, plus the total day length.

Primary use cases

  • "What time is sunrise/sunset in <place> on <date>?"
  • Planning around daylight (photography, scheduling, outdoor activity).
  • Computing day length across the year or by latitude.

Good to know

Provide latitude and longitude (decimal degrees). date defaults to today; timezone (IANA name) controls the output time zone and defaults to UTC. At extreme latitudes the sun may not rise or set on a given date; those fields are null and polar is true. Computed locally.

Parameters

datestringoptional

Date (YYYY-MM-DD). Defaults to today.

latitudenumberrequired

Latitude in decimal degrees.

timezonestringoptional

Optional IANA time zone for the output (e.g. America/New_York). Defaults to UTC.

longitudenumberrequired

Longitude in decimal degrees.

astronomy/sun — Faro