({{, (RefLink[SolarEclipse, paclet:ref/SolarEclipse])[] 
gives the time of the next solar eclipse.}, {, (RefLink[SolarEclipse, paclet:ref/SolarEclipse])[datespec]
gives the time for the next solar eclipse after the specified date.}, {, (RefLink[SolarEclipse, paclet:ref/SolarEclipse])[propertyspec]
gives the specified property value for the next solar eclipse.}, {, (RefLink[SolarEclipse, paclet:ref/SolarEclipse])[datespec,propertyspec]
gives the specified property value for the next solar eclipse after the specified date.}})

OpenersNotesSection(Spacer1)Details and Options

(RefLink[SolarEclipse, paclet:ref/SolarEclipse])[] makes use of (RefLink[$TimeZone, paclet:ref/$TimeZone]) to determine your time zone.

Dates can be specified as a (RefLink[DateObject, paclet:ref/DateObject]) or as a string that resolves to a date.

If datespec is a list of dates, then the results will contain (RefLink[EventSeries, paclet:ref/EventSeries]) or (RefLink[TimeSeries, paclet:ref/TimeSeries]) objects.

datespec can be specified as {start,end,increment} for compatibility with (RefLink[DateRange, paclet:ref/DateRange]) specifications.

datespec can be specified as {start,end,(RefLink[All, paclet:ref/All])} to obtain a list of the property values for all unique eclipses in the specified range.

(RefLink[SolarEclipse, paclet:ref/SolarEclipse])[(RefLink[TimeZone, paclet:ref/TimeZone])->z] gives the date of the next solar eclipse with date and time inferred for time zone z by assuming that your computer is set for the time zone specified by (RefLink[$TimeZone, paclet:ref/$TimeZone]).

(RefLink[SolarEclipse, paclet:ref/SolarEclipse])["MaximumEclipseDate"] is equivalent to (RefLink[SolarEclipse, paclet:ref/SolarEclipse])[].

(RefLink[SolarEclipse, paclet:ref/SolarEclipse]) can accept the following values for propertyspec:

(RefLink[SolarEclipse, paclet:ref/SolarEclipse]) can accept the following options:

Possible settings for (RefLink[TimeDirection, paclet:ref/TimeDirection]) include:

Possible settings for (RefLink[EclipseType, paclet:ref/EclipseType]) include:

OpenersPrimaryExamplesSection(Spacer1)Examples  (18)

OpenersExampleSection0(Spacer1)Basic Examples  (3)

Find the date of the next solar eclipse:

SolarEclipse[]

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

SolarEclipse[DateObject[{2017,1,1,0,0}]]

Find the type of the next solar eclipse:

SolarEclipse["Type"]

OpenersExampleSection1(Spacer1)Scope  (12)

OpenersExampleSubsection0(Spacer1)Dates  (4)

Dates can be specified as a (RefLink[DateObject, paclet:ref/DateObject]):

SolarEclipse[DateObject[{2017,1,1,0,0}]]

Dates can be specified as a date string:

SolarEclipse["Jan 1 2017 12:00AM"]

Generate the next solar eclipse for a range of dates:

SolarEclipse[DateRange[DateObject[{2014,1,1,0,0}],DateObject[{2018,1,1,0,0}],{2,"Week"}]]

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

SolarEclipse[{DateObject[{2014,1,1,0,0}],DateObject[{2018,1,1,0,0}],All},"MaximumEclipseDate"]

OpenersExampleSubsection1(Spacer1)Properties  (8)

Generate a map showing the regions of partiality and totality for the first total solar eclipse in 2017:

GeoGraphics[{GeoStyling[None],SolarEclipse[DateObject[{2017,1,1,0,0}],"GraphicsData",EclipseType->"Total"]},GeoProjection->"Equirectangular",GeoRange->"World"]

Determine the starting date for the first solar eclipse in 2017:

SolarEclipse[DateObject[{2017,1,1,0,0}],"MaximumEclipseDate"]

Generate a map showing the region of partiality for the first total solar eclipse in 2017:

GeoGraphics[{GeoStyling[None],Opacity[.3],SolarEclipse[DateObject[{2017,1,1,0,0}],"PartialPhasePolygon",EclipseType->"Total"]},GeoProjection->"Equirectangular"]

Determine the ending date for the first solar eclipse in 2017:

SolarEclipse[DateObject[{2017,1,1,0,0}],"TotalPhaseEndDate",EclipseType->"Total"]

Determine the starting date for the first total solar eclipse in 2017:

SolarEclipse[DateObject[{2017,1,1,0,0}],"TotalPhaseStartDate",EclipseType->"Total"]

Generate a map showing the region of totality for the first total solar eclipse in 2017:

GeoGraphics[{Red,SolarEclipse[DateObject[{2017,1,1,0,0}],"TotalPhaseCenterLine",EclipseType->"Total"]},GeoProjection->"Equirectangular"]

Generate a map showing the region of totality for the first total solar eclipse in 2017:

GeoGraphics[{GeoStyling[None],Opacity[.3],Red,SolarEclipse[DateObject[{2017,1,1,0,0}],"TotalPhasePolygon",EclipseType->"Total"]},GeoProjection->"Equirectangular"]

Determine the type of the first solar eclipse in 2017:

SolarEclipse[DateObject[{2017,1,1,0,0}],"Type"]

OpenersExampleSection2(Spacer1)Possible Issues  (2)

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

SolarEclipse[DateObject[{2017}]]

The following expanded form gives the same result:

SolarEclipse[DateObject[{2017,1,1,0,0,0}]]

OpenersExampleSection3(Spacer1)Neat Examples  (1)

Generate a map showing the paths of all total solar eclipses between 2010 and 2020:

GeoGraphics[{GeoStyling[None],Opacity[.3],Red,SolarEclipse[{DateObject[{2010,1,1,0,0}],DateObject[{2020,1,1,0,0}],All},"TotalPhasePolygon",EclipseType->"Total"]},GeoProjection->"Equirectangular"]

({{DocumentationFooterIconsRelatedFunction.png, ({{See Also}, {(RefLink[LunarEclipse, paclet:ref/LunarEclipse])  ▪  (RefLink[SunPosition, paclet:ref/SunPosition])  ▪  (RefLink[MoonPosition, paclet:ref/MoonPosition])  ▪  (RefLink[StarData, paclet:ref/StarData])  ▪  (RefLink[MoonPhase, paclet:ref/MoonPhase])  ▪  (RefLink[PlanetaryMoonData, paclet:ref/PlanetaryMoonData])}})}})

({{DocumentationFooterIconsRelatedGuide.png, ({{Related Guides}, {▪(RefLinkPlain[Astronomical Computation & Data, paclet:guide/AstronomicalComputationAndData])}, {▪(RefLinkPlain[People & History, paclet:guide/PeopleAndHistory])}})}})