Perl 5 version 14.2 documentation
Time::Seconds - a simple API to convert seconds to other date values
This module is part of the Time::Piece distribution. It allows the user to find out the number of minutes, hours, days, weeks or years in a given number of seconds. It is returned by Time::Piece when you delta two Time::Piece objects.
Time::Seconds also exports the following constants:
Since perl does not (yet?) support constant objects, these constants are in
seconds only, so you cannot, for example, do this:
The following methods are available:
- my $val = Time::Seconds->new(SECONDS)
- $val->financial_months; # 30 days
- $val->pretty; # gives English representation of the delta
The usual arithmetic (+,-,+=,-=) is also available on the objects.
The methods make the assumption that there are 24 hours in a day, 7 days in a week, 365.24225 days in a year and 12 months in a year. (from The Calendar FAQ at http://www.tondering.dk/claus/calendar.html)
Matt Sergeant, email@example.com
Tobias Brox, firstname.lastname@example.org
Balï¿½zs Szabï¿½ (dLux), email@example.com
Please see Time::Piece for the license.
Currently the methods aren't as efficient as they could be, for reasons of clarity. This is probably a bad idea.