NAME

Time::Keeper::Moon::Day - the moon on one civil day in a zone

VERSION

Version 0.01

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 noon

DESCRIPTION

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).

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)