NAME
Time::Keeper::Moon::Day - the moon on one civil day in a zone
VERSION
Version 0.03
SYNOPSIS
my $day = Time::Keeper::Moon->on($date, zone => 'Europe/London');
$day->phase_name; # full, or waning_gibbous
$day->phase; # the full moon's value, or undef
$day->illumination; # at local noon
$day->age; # days, at local noonDESCRIPTION
What "on" in Time::Keeper::Moon gives: the moon on one civil day in the zone, which runs from the midnight the zone had to the next.
METHODS
phase_name
The principal phase that falls in the day (new, first_quarter, full, last_quarter), when one does; else the name of the stretch the day lies in (waxing_crescent, waxing_gibbous, waning_gibbous, waning_crescent). So the day a new moon falls on is new wherever in the day it falls, and the days either side are crescents.
phase
The principal phase's value, in the zone, or undef when none falls in the day.
illumination
age
The fraction of the disk lit, and the days since the last new moon, both at local noon (the first moment after it where the clocks skipped it).
moonrise
moonset
moon_transit
The first moonrise, moonset or upper transit in the day, or undef; the day must have been made with a place, or these die naming it. See "THE MOON'S DAY" in Time::Keeper::Moon.
moonrises
moonsets
moon_transits
Every one of the kind in the day, in order: none, one or two.
is_moon_up_all_day
is_moon_down_all_day
True when the moon neither rose nor set in the day and was above, or below, the horizon throughout.
events
Every event of the day in order of time, each a reference to a two-element array of its name and value: the principal phase (new, first_quarter, full, last_quarter) when one falls in the day, and with a place moonrise, moonset and moon_transit.
place
The Time::Keeper::Sun place the day was made with, or undef when it was made without one.
date
The day, as a Time::Keeper::Date.
zone_name
The zone's name.
start
end
noon
The window's edges and its noon, as values.
AUTHOR
LNATION, <email at lnation.org>
LICENSE AND COPYRIGHT
This software is Copyright (c) 2026 by LNATION.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)