Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

timetrans(1p) [debian man page]

TIMETRANS(1p)						User Contributed Perl Documentation					     TIMETRANS(1p)

NAME

       timetrans - Converts time into time

SYNOPSIS

	 timetrans [units-options] [-count]

DESCRIPTION

       timetrans converts time from one type of unit to another.  If any of the units options are specified, then timetrans will convert those
       time units into the number of seconds to which they add up.  If given the count option, timetrans will convert that number of seconds into
       the appropriate number of weeks, days, hours, minutes, and seconds.  The converted result is printed out.  Units options cannot be
       specified in the same execution as the count option, and vice versa.

       timetrans is intended for use with DNSSEC-Tools, for calculating a zone's expiration time.

OPTIONS

   Units Options
       The converted value of each unit is totaled and a single result printed.

       -seconds seconds
	   Count of seconds to convert to seconds.

       -minutes minutes
	   Count of minutes to convert to seconds.

       -hours hours
	   Count of hours to convert to seconds.

       -days days
	   Count of days to convert to seconds.

       -weeks weeks
	   Count of weeks to convert to seconds.

   Count Option
       The specified seconds count is converted to the appropriate number of weeks, days, hours, minutes, and seconds.

       -count seconds
	   Count of seconds to convert to the appropriate set of units.

   Other Options
       timetrans has the following miscellaneous options.

       -Version
	   Displays the version information for timetrans and the DNSSEC-Tools package.

EXAMPLES

       Example 1:  Converting 5 days into seconds

	   $(42)> timetrans -days 5
	   432000

       Example 2:  Converting 2 weeks into seconds

	   $(43)> timetrans -w 2
	   1209600

       Example 3:  Converting 8 days and 8 hours into seconds

	   $(44)> timetrans -d 8 -hours 8
	   720000

       Example 4:  Converting 1 week, 1 day, and 8 hours into seconds

	   $(46)> timetrans -w 1 -days 1 -h 8
	   720000

       Example 5:  Converting 14 weeks, 4 days, 21 hours, 8 minutes, and 8 seconds into seconds

	   $(47)> timetrans -w 14 -d 4 -h 21 -m 8 -s 8
	   8888888

       Example 6:  Converting 720000 seconds into time units

	   $(48)> timetrans -c 720000
	   1 week, 1 day, 8 hours

       Example 7:  Converting 1814421 seconds into time units

	   $(49)> timetrans -c 1814421
	   3 weeks, 21 seconds

       Example 8:  Converting 8888888 seconds into time units

	   $(50)> timetrans -c 8888888
	   14 weeks, 4 days, 21 hours, 8 minutes, 8 seconds

COPYRIGHT

       Copyright 2004-2012 SPARTA, Inc.  All rights reserved.  See the COPYING file included with the DNSSEC-Tools package for details.

AUTHOR

       Wayne Morrison, tewok@tislabs.com

SEE ALSO

       zonesigner(8)

       Net::DNS::SEC::Tools::timetrans.pm(3)

perl v5.14.2							    2012-06-21							     TIMETRANS(1p)

Check Out this Related Man Page

Time::Seconds(3pm)					 Perl Programmers Reference Guide					Time::Seconds(3pm)

NAME

       Time::Seconds - a simple API to convert seconds to other date values

SYNOPSIS

	   use Time::Piece;
	   use Time::Seconds;

	   my $t = localtime;
	   $t += ONE_DAY;

	   my $t2 = localtime;
	   my $s = $t - $t2;

	   print "Difference is: ", $s->days, "
";

DESCRIPTION

       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:

	   ONE_DAY
	   ONE_WEEK
	   ONE_HOUR
	   ONE_MINUTE
	   ONE_MONTH
	   ONE_YEAR
	   ONE_FINANCIAL_MONTH
	   LEAP_YEAR
	   NON_LEAP_YEAR

       Since perl does not (yet?) support constant objects, these constants are in seconds only, so you cannot, for example, do this: "print
       ONE_WEEK->minutes;"

METHODS

       The following methods are available:

	   my $val = Time::Seconds->new(SECONDS)
	   $val->seconds;
	   $val->minutes;
	   $val->hours;
	   $val->days;
	   $val->weeks;
	       $val->months;
	       $val->financial_months; # 30 days
	   $val->years;
	   $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)

AUTHOR

       Matt Sergeant, matt@sergeant.org

       Tobias Brox, tobiasb@tobiasb.funcom.com

       BalieXXzs SzabieXX (dLux), dlux@kapu.hu

LICENSE

       Please see Time::Piece for the license.

Bugs
       Currently the methods aren't as efficient as they could be, for reasons of clarity. This is probably a bad idea.

perl v5.16.2							    2012-10-11							Time::Seconds(3pm)
Man Page