Files
astronomy/source/kotlin/doc/search-lunar-eclipse.md
Don Cross 5676049596 Kotlin: added iterator helper functions
Added the following iterator functions that wrap
search/next pairs of functions:

    globalSolarEclipsesAfter
    localSolarEclipsesAfter
    lunarApsidesAfter
    lunarEclipsesAfter
    moonNodesAfter
    moonQuartersAfter
    planetApsidesAfter
    transitsAfter

I updated the following Kotlin demos:

    MoonPhase.kt    ==> moonQuartersAfter
    LunarEclipse.kt ==> lunarEclipsesAfter

However, I have not yet figured out how to use these
functions in the corresponding Java demos.
2022-05-06 21:52:27 -04:00

22 lines
1022 B
Markdown

//[astronomy](../../index.md)/[io.github.cosinekitty.astronomy](index.md)/[searchLunarEclipse](search-lunar-eclipse.md)
# searchLunarEclipse
fun [searchLunarEclipse](search-lunar-eclipse.md)(startTime: [Time](-time/index.md)): [LunarEclipseInfo](-lunar-eclipse-info/index.md)
Searches for a lunar eclipse.
This function finds the first lunar eclipse that occurs after startTime. A lunar eclipse may be penumbral, partial, or total. See [LunarEclipseInfo](-lunar-eclipse-info/index.md) for more information. To find a series of lunar eclipses, call this function once, then keep calling [nextLunarEclipse](next-lunar-eclipse.md) as many times as desired, passing in the center value returned from the previous call.
See [lunarEclipsesAfter](lunar-eclipses-after.md) for convenient iteration of consecutive lunar eclipses.
#### Return
Information about the first lunar eclipse that occurs after startTime.
## Parameters
| | |
|---|---|
| startTime | The date and time for starting the search for a lunar eclipse. |