NAME

Time::Keeper::Body::Day - what a planet's day and a star's day share

VERSION

Version 0.01

SYNOPSIS

my $d = $sky->on($date, 'jupiter');       # a Time::Keeper::Planet::Day
my $d = $sky->on($date, 'Sirius');        # a Time::Keeper::Star::Day
$d->isa('Time::Keeper::Body::Day');       # both

$d->body;                                 # 'jupiter', 'Sirius'
$d->rise;  $d->set;  $d->transit;          # values, or undef
$d->rises;  $d->sets;  $d->transits;       # all of them in the day
$d->events;                               # ([rise => value], [transit => value], ...)
$d->is_up_all_day;  $d->is_down_all_day;

DESCRIPTION

The methods of Time::Keeper::Planet::Day and Time::Keeper::Star::Day, which inherit them. A day of either is made by its class's on, or by "on" in Time::Keeper::Sky with the body's name; this class makes none of its own.

METHODS

rise

set

transit

The first rise, set or upper transit in the day, as a Time::Keeper value in the place's zone, or undef.

rises

sets

transits

All of them in the day, in order (two at most).

events

Every event of the day in order of time, as [name, value] pairs, the names rise, set and transit.

is_up_all_day

is_down_all_day

On a day with neither a rise nor a set, which way it went.

body

The body's name: the planet's, or the star's IAU name (HR n for a star without one).

date

zone_name

start

end

place

The day: its Time::Keeper::Date, its zone's name, its first moment and the next day's, and the place (a Time::Keeper::Sun, which is a Time::Keeper::Sky).

SEE ALSO

Time::Keeper::Planet::Day, Time::Keeper::Star::Day, Time::Keeper::Sky.

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)