LunarEclipse

LunarEclipse[]

gives the time of the next lunar eclipse.

LunarEclipse[datespec]

gives the time for the next lunar eclipse after the specified date.

LunarEclipse[propertyspec]

gives the specified property value for the next lunar eclipse.

LunarEclipse[datespec,propertyspec]

gives the specified property value for the next lunar eclipse after the specified date.

Details and Options

  • LunarEclipse[] makes use of $TimeZone to determine your time zone.
  • Dates can be specified as a DateObject or as a string that resolves to a date.
  • If datespec is a list of dates, then the results will contain EventSeries or TimeSeries objects.
  • datespec can be specified as {start,end,increment} for compatibility with DateRange specifications.
  • datespec can be specified as {start,end,All} to obtain a list of the property values for all unique eclipses in the specified range.
  • LunarEclipse[TimeZone->z] gives the date of the next lunar eclipse with date and time inferred for time zone z by assuming that your computer is set for the time zone specified by $TimeZone.
  • LunarEclipse["MaximumEclipseDate"] is equivalent to LunarEclipse[].
  • LunarEclipse can accept the following values for propertyspec:
  • "GraphicsData"graphics directives for all phases of the eclipse
    "MaximumEclipseDate"date of the maximum of the eclipse
    "PartialPhaseEndDate"date of the end of the partial phase of the eclipse
    "PartialPhaseStartDate"date of the start of the partial phase of the eclipse
    "PartialPhasePolygon"polygon representing the partial phase of the eclipse
    "TotalPhaseEndDate"date of the end of the total phase of the eclipse
    "TotalPhaseStartDate"date of the start of the total phase of the eclipse
    "TotalPhasePolygon"polygon representing the total phase of the eclipse
    "Type"type of the eclipse
  • LunarEclipse can accept the following options:
  • TimeDirection1whether to return the next or last lunar eclipse
    EclipseTypeAutomaticused to specify the type of lunar eclipse
    TimeZone$TimeZonetime zone to be used for dates
  • Possible settings for TimeDirection include:
  • 1returns the next lunar eclipse from the specified date
    -1returns the last lunar eclipse from the specified date
  • Possible settings for EclipseType include:
  • Automaticreturns the next eclipse of any type
    "Partial"returns the next penumbral eclipse
    "Total"returns the next total eclipse

Examples

open allclose all

Basic Examples  (3)

Find the date of the next lunar eclipse:

Find the date of the next lunar eclipse after a specified date:

Find the type of the next lunar eclipse:

Scope  (13)

Dates  (4)

Dates can be specified as a DateObject:

Dates can be specified as a date string:

Generate the next lunar eclipse for a range of dates:

Generate a list of the dates of unique lunar eclipses for a range of dates:

Properties  (9)

Generate a map showing the regions for the first lunar eclipse in 2015:

Determine the starting date for the first lunar eclipse in 2015:

Generate a map showing the region of partiality for the first total lunar eclipse in 2015:

Determine the end of totality for the first total lunar eclipse in 2015:

Determine the start of totality for the first total lunar eclipse in 2015:

Determine the end of the partial phase for the first total lunar eclipse in 2015:

Determine the start of the partial phase for the first total lunar eclipse in 2015:

Generate a map showing the region of totality for the first total lunar eclipse in 2015:

Determine the type of the first lunar eclipse in 2015:

Possible Issues  (2)

Short date specifications are automatically padded; the following example is understood to mean the first lunar eclipse after midnight on January 1, 2015:

The following expanded form gives the same result:

Neat Examples  (1)

Generate a map showing the paths of all total lunar eclipses between 2010 and 2012:

Introduced in 2014
 (10.0)