NAME

Date::Lectionary::Time

VERSION

Version 1.20160809

SYNOPSIS

Working in the liturgical time of the lectionary means tracking time relative to Sundays. This is a quick utility to find the next or previous Sunday relative to a given date or the closest Sunday to a given date.

	use Time::Piece;
    use Date::Lectionary::Time qw(nextSunday prevSunday closestSunday);

    my $christmasDay = Time::Piece->strptime("2015-12-25", "%Y-%m-%d");
    my $sundayAfterChristmas = nextSunday($christmasDay);
    my $sundayBeforeChristmas = prevSunday($christmasDay);
		my $sundayClosestToChristmas = closestSunday($christmasDay);

EXPORT

nextSunday prevSunday closestSunday

SUBROUTINES/METHODS

nextSunday

For a given Time::Piece date returns a Time::Piece object of the date of the Sunday immediately following the given date.

prevSunday

For a given Time::Piece date returns a Time::Piece object of the date of the Sunday immediately before the given date.

closestSunday

For a given Time::Piece date returns a Time::Piece object of the date of the Sunday closest to the given date.

AUTHOR

Michael Wayne Arnold, <marmanold at cpan.org>

BUGS

Please report any bugs or feature requests to bug-date-lectionary-time at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Date-Lectionary-Time. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Date::Lectionary::Time

You can also look for information at:

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

Copyright 2016 Michael Wayne Arnold.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.