Lunar Provider

The Lunar Provider calculates dates, times, moon phases and related information for a given date and timezone using the astronomical algorithms of Jean Meeus.

Configuration

  • Date
    The date (and timezone) for the lunation (moon phase) cycle calculation.
    The date must be an ISO formatted time like yyyy-MM-dd’T’HH:mm:ssXX with timezone info, e.g. from the Time provider, a date format of yyyy-MM-dd (using the local timezone) or leave it empty for the actual date.

  • Result Timezone
    The timezone for the calculated result times.
    This is normally the timezone of the current location (System default).

    Note
    If your actual location is Berlin and you want to know the moon phase times given in local time for New York, set the Date and its timezone to "Europe/Berlin" and select for the Result timezone "America/New_York".

Query

  • Status

    Text Numeric Description

    N/A

    0

    Date is invalid

    Excellent

    1

    Date is valid

    Fail

    5

    Calculation failure

  • New Moon
    Date and time of the New Moon on which the lunation cycle started.

  • First Quarter
    Date and time of the First Quarter Moon in the lunation cycle.

  • Full Moon
    Date and time of Full Moon in the lunation cycle.

  • Third Quarter
    Date and time of the Third Quarter Moon in the lunation cycle.

  • Next New Moon
    Date and time of the next New Moon of the next lunation cycle.

  • Lunation Number
    A lunation, or lunar month, is the time it takes the Moon to pass through all of the Moon phases, measured from one New Moon to the next New Moon. Professor Ernest W. Brown invented a lunation number system which counts the lunations, starting the first New Moon on January 17, 1923.

  • Phase as Percentage
    Returns the progress of the current moon phase as percentage.

    0

    New moon

    25

    First Quarter

    50

    Full moon

    75

    Last Quarter

    99.99

    Nearly New Moon again

  • Icon
    Icon name of the moon phase. This can be used as input for the Icon Facelet.

    % of Moon Phase

    Icon Name

    95 - 4

    moon_new

    5 - 19

    moon_waxing_crescent

    20 - 29

    moon_first_quarter

    30 - 44

    moon_waxing_gibbous

    45 - 54

    moon_full

    55 - 69

    moon_waning_gibbous

    70 - 79

    moon_third_quarter

    80 - 94

    moon_waning_crescent

  • Is Waxing
    Returns 1 if the moon in the waxing phase (new to full moon), 0 if the moon in the waning phase (full to new moon).