B4A Library PndCommonsSunCalc - [B4A/B4J] library for calculation of sun and moon positions and phases.

Lightweight, only requires Java 8 or higher, no other dependencies. Android compatible, requires API level 26 (Android 8.0 "Oreo") or higher.

Accuracy
Astronomical calculations are far more complex than throwing a few numbers into an obscure formula and then getting a fully accurate result. There is always a tradeoff between accuracy and computing time.
This library has its focus on getting acceptable results at low cost, so it can also run on mobile devices, or devices with a low computing power. The results have an accuracy of about a minute, which should be good enough for common applications (like sunrise/sunset timers), but is probably not sufficient for astronomical purposes.
If you are looking for the highest possible accuracy, you are looking for a different library.

Original library: https://github.com/shred/commons-suncalc
Wrapper is based on v3.5 version.

PndCommonsSunCalc

Author: Author: Richard Körber - B4A/B4J Wrapper: Pendrush
Version: 1.0

• PndCommonsSunCalc
  • Fields:
    • MOONPHASE_PHASE_FIRST_QUARTER As org.shredzone.commons.suncalc.MoonPhase.Phase
      Waxing half moon
    • MOONPHASE_PHASE_FULL_MOON As org.shredzone.commons.suncalc.MoonPhase.Phase
      Full moon
    • MOONPHASE_PHASE_LAST_QUARTER As org.shredzone.commons.suncalc.MoonPhase.Phase
      Waning half moon
    • MOONPHASE_PHASE_NEW_MOON As org.shredzone.commons.suncalc.MoonPhase.Phase
      New moon
    • MOONPHASE_PHASE_WANING_CRESCENT As org.shredzone.commons.suncalc.MoonPhase.Phase
      Waning crescent moon
    • MOONPHASE_PHASE_WANING_GIBBOUS As org.shredzone.commons.suncalc.MoonPhase.Phase
      Waning gibbous moon
    • MOONPHASE_PHASE_WAXING_CRESCENT As org.shredzone.commons.suncalc.MoonPhase.Phase
      Waxing crescent moon
    • MOONPHASE_PHASE_WAXING_GIBBOUS As org.shredzone.commons.suncalc.MoonPhase.Phase
      Waxing gibbous moon
    • TWILIGHT_ASTRONOMICAL As org.shredzone.commons.suncalc.SunTimes.Twilight
      Astronomical twilight
    • TWILIGHT_BLUE_HOUR As org.shredzone.commons.suncalc.SunTimes.Twilight
      Transition from Golden Hour to Blue Hour
    • TWILIGHT_CIVIL As org.shredzone.commons.suncalc.SunTimes.Twilight
      Civil twilight
    • TWILIGHT_GOLDEN_HOUR As org.shredzone.commons.suncalc.SunTimes.Twilight
      Transition from daylight to Golden Hour
    • TWILIGHT_HORIZON As org.shredzone.commons.suncalc.SunTimes.Twilight
      The moment when the center of the sun crosses the horizon.
    • TWILIGHT_NAUTICAL As org.shredzone.commons.suncalc.SunTimes.Twilight
      Nautical twilight
    • TWILIGHT_NIGHT_HOUR As org.shredzone.commons.suncalc.SunTimes.Twilight
      Transition from Blue Hour to night
    • TWILIGHT_VISUAL As org.shredzone.commons.suncalc.SunTimes.Twilight
      The moment when the visual upper edge of the sun crosses the horizon. This is the default.
    • TWILIGHT_VISUAL_LOWER As org.shredzone.commons.suncalc.SunTimes.Twilight
      The moment when the visual lower edge of the sun crosses the horizon.
  • Functions:
    • Initialize
      Initialize PndCommonsSunCalc
    • MoonIllumination (Year As Int, Month As Int, Day As Int) As Double
      MoonIllumination - Calculates the illumination of the moon in percent.
      Year - Year
      Month - Month (1 = January, 2 = February, ...)
      Day - Day of month
    • MoonPhase (Year As Int, Month As Int, Day As Int, HowManyToFind As Int, MoonPhaseConst As org.shredzone.commons.suncalc.MoonPhase.Phase) As List
      MoonPhase - Calculates the date and time when the moon reaches the desired phase.
      Note: Due to the simplified formulas used in suncalc, the returned time can have an error of several minutes.
      Year - Year
      Month - Month (1 = January, 2 = February, ...)
      Day - Day of month
      HowManyToFind - How many result you want to be returned in the List
      MoonPhaseConst - Use on of the MOONPHASE_PHASE constants
    • MoonPhaseMicroMoon (Year As Int, Month As Int, Day As Int, HowManyToFind As Int) As List
      MoonPhaseMicroMoon - Checks if the moon is in a MicroMoon position.
      Note that there is no official definition of micromoon.
      Suncalc will assume a micromoon if the center of the moon is farther than 405,000 km from the center of Earth.
      Usually only full moons or new moons are candidates for micromoons.
      Year - Year
      Month - Month (1 = January, 2 = February, ...)
      Day - Day of month
      HowManyToFind - How many result you want to be returned in the List
    • MoonPhaseSuperMoon (Year As Int, Month As Int, Day As Int, HowManyToFind As Int) As List
      MoonPhaseSuperMoon - Checks if the moon is in a SuperMoon position.
      Note that there is no official definition of supermoon.
      Suncalc will assume a supermoon if the center of the moon is closer than 360,000 km to the center of Earth.
      Usually only full moons or new moons are candidates for supermoons.
      Year - Year
      Month - Month (1 = January, 2 = February, ...)
      Day - Day of month
      HowManyToFind - How many result you want to be returned in the List
    • MoonRise (Latitude As Double, Longitude As Double, Year As Int, Month As Int, Day As Int) As Long
      MoonRise - Moonrise time.
      Latitude - Latitude, in degrees
      Longitude - Longitude, in degrees
      Year - Year
      Month - Month (1 = January, 2 = February, ...)
      Day - Day of month
    • MoonSet (Latitude As Double, Longitude As Double, Year As Int, Month As Int, Day As Int) As Long
      MoonSet - Moonset time.
      Latitude - Latitude, in degrees
      Longitude - Longitude, in degrees
      Year - Year
      Month - Month (1 = January, 2 = February, ...)
      Day - Day of month
    • Sunrise (Latitude As Double, Longitude As Double, Year As Int, Month As Int, Day As Int) As Long
      Compute the sunrise.
      Latitude - Latitude, in degrees
      Longitude - Longitude, in degrees
      Year - Year
      Month - Month (1 = January, 2 = February, ...)
      Day - Day of month
    • Sunset (Latitude As Double, Longitude As Double, Year As Int, Month As Int, Day As Int) As Long
      Compute the sunset times.
      Latitude - Latitude, in degrees
      Longitude - Longitude, in degrees
      Year - Year
      Month - Month (1 = January, 2 = February, ...)
      Day - Day of month
    • TwilightRise (Latitude As Double, Longitude As Double, Year As Int, Month As Int, Day As Int, Twilight As org.shredzone.commons.suncalc.SunTimes.Twilight) As Long
      Twilight Rise
      The twilight angles use a geocentric reference, by definition.
      However, VISUAL and VISUAL_LOWER are topocentric, and take the spectator's height and the atmospheric refraction into account.
      Latitude - Latitude, in degrees
      Longitude - Longitude, in degrees
      Year - Year
      Month - Month (1 = January, 2 = February, ...)
      Day - Day of month
      Twilight - use one of the TWILIGHT constant
    • TwilightSet (Latitude As Double, Longitude As Double, Year As Int, Month As Int, Day As Int, TwilightConst As org.shredzone.commons.suncalc.SunTimes.Twilight) As Long
      Twilight Set
      The twilight angles use a geocentric reference, by definition.
      However, VISUAL and VISUAL_LOWER are topocentric, and take the spectator's height and the atmospheric refraction into account.
      Latitude - Latitude, in degrees
      Longitude - Longitude, in degrees
      Year - Year
      Month - Month (1 = January, 2 = February, ...)
      Day - Day of month
      Twilight - use one of the TWILIGHT constant

Click to expand...