Sunset

Sunset[]

gives the time of the next sunset for the current date and location.

Sunset[datespec]

gives the time of the next sunset for the specified dates.

Sunset[locationspec]

gives the times of the next sunset for the specified locations.

Sunset[locationspec,datespec]

gives the time of the next sunset for the specified date and location.

Sunset[{{location1,date1},{location2,date2},}]

gives the times of the next sunset for all specified locations on the specified dates.

Sunset[locationspec,datespec,func]

uses func to determine what to return for extended locations.

Details and Options

  • Sunset, also known as sundown, is defined as the instant of time when the upper rim of the Sun's disk appears to make contact with the horizon as it is setting.
  • The observation location can be any point on the surface of a body in the solar system, defining the local horizon.
  • Locations can be specified as Entity objects, assuming they represent objects with geographic coordinates, or they can be latitude/longitude pairs, assuming degrees as units.
  • Sunset[] makes use of $GeoLocation and $TimeZone to determine your location and time zone.
  • datespec can be a DateObject expression, a TimeObject expression, a date string or a {y,m,d,h,m,s} date list.
  • datespec is assumed to be in $TimeZone, unless it is a DateObject or TimeObject expression with an explicit TimeZone option value.
  • locationspec and datespec can be either individual items or lists of them.
  • If datespec is a list of dates, then the results will contain EventSeries objects.
  • datespec can be specified as {start,end,increment} for compatibility with DateRange specifications.
  • Sunset[,func] is used to specify the format of output when locations are specified.
  • Possible settings for func include:
  • Automaticreturns intervals for extended locations only
    Intervalreturns intervals for all specified locations
    Meanreturns mean value for extended locations
    Minreturns minimum values for extended locations
    Maxreturns maximum values for extended locations
    StandardDeviationreturns standard deviation for extended locations
  • Sunrise[TimeZone->z] gives the date of the next sunset with date and time inferred for time zone z by assuming that your computer is set for the time zone specified by $TimeZone.
  • Sunset[TimeDirection->-1] gives the date of the last sunset.
  • Sunset can accept the following options:
  • ReferenceAltitude Automaticaltitude value defining the instant of rise/set
    TimeDirection 1whether to return the next or last Sunrise
    TimeZone $TimeZonetime zone to be used for dates
  • Possible settings for TimeDirection include:
  • 1returns the next sunset from the specified date
    -1returns the last sunset from the specified date
  • Possible values of the ReferenceAltitude option include:
  • Automaticupper limb of the Sun crosses zero altitude
    altcenter of the Sun crosses numeric altitude alt
    {alt,limb}the given limb of the Sun crosses numeric altitude alt
  • The reference altitude angle alt can be given as a Quantity angle or as a numeric expression interpreted in angular degrees. These are the traditional values of reference altitude:
  • "Civil"the center of the Sun has altitude 6 degrees
    "Nautical"the center of the Sun has altitude 12 degrees
    "Astronomical"the center of the Sun has altitude 18 degrees
  • Possible values for the limb of the Sun include:
  • "UpperLimb"upper limb of the Sun
    "Center"central point of the Sun
    "LowerLimb"lower limb of the Sun
    limbnumeric value between 1 (lower limb) and 1 (upper limb)
  • Calculations are based on atmospheric refraction models that cannot be accurately predicted. This, combined with local topography deviations, can result in errors on the order of several minutes from actual observed times.

Examples

open allclose all

Basic Examples  (6)

Compute the next sunset for your current location:

Compute the next sunset after a specified date:

Compute the next sunset for a specified location:

Compute the next sunset for a specified latitude/longitude and date:

Compute the next sunset for a specified city and date:

Generate the time of the next sunset:

Scope  (13)

Dates  (4)

Dates can be specified as a DateObject:

Dates can be specified as a date string:

Dates can be specified as a TimeObject:

Generate the next sunset for a range of dates:

Locations  (7)

Locations can be latitude/longitude pairs:

Locations can include elevation:

Cities are treated as single, specific locations:

Results for extended locations are intervals, by default:

The form of the results for extended locations can be overridden:

Locations can also be off Earth:

Generate the next sunset for multiple locations:

Time Zones  (2)

Express the next sunset at your geo location in the GMT time zone:

Find the sunset for a specified location and time in GMT:

Options  (4)

ReferenceAltitude  (2)

By default, Sunset reports the instant when the upper limb of the Sun has altitude zero:

Therefore, the actual center of the body is below the horizon:

Use a specific value of altitude and choice of limb:

Find the next date of sunset, by default using the horizon and the upper limb of the Sun:

Use the same horizon at zero apparent altitude, but now comparing to the center of the Sun:

Find the starting time of evening civil, nautical and astronomical twilight, all defined by the center of the Sun:

TimeZone  (1)

Find the sunset in Greenwich, United Kingdom:

TimeDirection  (1)

Find the last sunset for your location:

Applications  (1)

Determine your final location if you walk toward the Sun from sunrise to sunset at a constant speed:

Iterate the bearing in 10-minute increments to obtain a new course and destination:

Visualize the resulting path:

Find the distance between the starting and ending points:

Properties & Relations  (3)

By default, location is specified by $GeoLocation and the date is specified by the current date:

Results are in the form of an EventSeries when a range of dates is specified:

Calculate the next sunset, defined as when the upper edge of the Sun's apparent disk touches the horizon:

Find the position of the center of the Sun at that time:

The altitude of the Sun corresponds to its angular radius:

Eliminating atmospheric refraction effects, the true position of the Sun is revealed to be even further below the horizon at sunset:

Possible Issues  (3)

Since the value of $TimeZone may change throughout the year, the results for specified dates may vary depending on when you evaluate the input:

If the above behavior is a concern, the TimeZone option can be used to enforce a consistent value:

With Sunset[location,Interval], results for specific locations are coerced into intervals:

Sunset returns values taking into account atmospheric refraction effects:

These effects are especially large near the horizon, but the effects are turned off a few degrees below the horizon:

Use the "TrueAltitude" method to deactivate atmospheric refraction and compare with the previous result:

Neat Examples  (4)

Plot the position of the Sun for your location between sunrise and sunset for the solstices and equinox:

Generate a map of Italy with the illumination set for sunset:

Generate a table of sunsets for the capital cities in Europe and display only the first and last five:

Plot the length of daylight throughout a given year:

Wolfram Research (2014), Sunset, Wolfram Language function, https://reference.wolfram.com/language/ref/Sunset.html (updated 2024).

Text

Wolfram Research (2014), Sunset, Wolfram Language function, https://reference.wolfram.com/language/ref/Sunset.html (updated 2024).

CMS

Wolfram Language. 2014. "Sunset." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2024. https://reference.wolfram.com/language/ref/Sunset.html.

APA

Wolfram Language. (2014). Sunset. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/Sunset.html

BibTeX

@misc{reference.wolfram_2024_sunset, author="Wolfram Research", title="{Sunset}", year="2024", howpublished="\url{https://reference.wolfram.com/language/ref/Sunset.html}", note=[Accessed: 09-November-2024 ]}

BibLaTeX

@online{reference.wolfram_2024_sunset, organization={Wolfram Research}, title={Sunset}, year={2024}, url={https://reference.wolfram.com/language/ref/Sunset.html}, note=[Accessed: 09-November-2024 ]}