.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "timetrans 3pm"
.TH timetrans 3pm "2012-06-18" "perl v5.14.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Net::DNS::SEC::Tools::timetrans \- Convert an integer seconds count into text units.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&  use Net::DNS::SEC::Tools::timetrans;
\&
\&  $timestring = timetrans(86488);
\&
\&  $timestring = fuzzytimetrans(86488);
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The \fItimetrans\fR() interface in \fBNet::DNS::SEC::Tools::timetrans\fR converts an
integer seconds count into the equivalent number of days, hours, and minutes.
The time converted is a relative time, \fBnot\fR an absolute time.  The returned
time is given in terms of days, hours, minutes, and seconds, as required to
express the seconds count appropriately.
.PP
The \fIfuzzytimetrans\fR() interface converts an integer seconds count into the
equivalent number of weeks \fBor\fR days \fBor\fR hours \fBor\fR minutes.  The unit
chosen is that which is most natural for the seconds count.  One decimal
place of precision is included in the result.
.SH "INTERFACES"
.IX Header "INTERFACES"
The interfaces to the \fBNet::DNS::SEC::Tools::timetrans\fR module are given
below.
.SS "\fB\fP\f(BItimetrans()\fP\fB\fP"
.IX Subsection "timetrans()"
This routine converts an integer seconds count into the equivalent number of
days, hours, and minutes.  This converted seconds count is returned as a text
string.  The seconds count must be greater than zero or an error will be
returned.
.PP
Return Values:
.PP
.Vb 2
\&    If a valid seconds count was given, the count converted into the
\&        appropriate text string will be returned.
\&
\&    An empty string is returned if no seconds count was given or if
\&        the seconds count is less than one.
.Ve
.SS "\fB\fP\f(BIfuzzytimetrans()\fP\fB\fP"
.IX Subsection "fuzzytimetrans()"
This routine converts an integer seconds count into the equivalent number of
weeks, days, hours, or minutes.  This converted seconds count is returned
as a text string.  The seconds count must be greater than zero or an error
will be returned.
.PP
Return Values:
.PP
.Vb 2
\&    If a valid seconds count was given, the count converted into the
\&        appropriate text string will be returned.
\&
\&    An empty string is returned if no seconds count was given or if
\&        the seconds count is less than one.
.Ve
.SH "EXAMPLES"
.IX Header "EXAMPLES"
\&\fItimetrans(400)\fR returns 6 minutes, 40 seconds
.PP
\&\fItimetrans(420)\fR returns 7 minutes
.PP
\&\fItimetrans(888)\fR returns 14 minutes, 48 seconds
.PP
\&\fItimetrans(86400)\fR returns 1 day
.PP
\&\fItimetrans(86488)\fR returns 1 day, 28 seconds
.PP
\&\fItimetrans(715000)\fR returns 8 days, 6 hours, 36 minutes, 40 second
.PP
\&\fItimetrans(720000)\fR returns 8 days, 8 hours
.PP
\&\fIfuzzytimetrans(400)\fR returns 6.7 minutes
.PP
\&\fIfuzzytimetrans(420)\fR returns 7.0 minutes
.PP
\&\fIfuzzytimetrans(888)\fR returns 14.8 minutes
.PP
\&\fIfuzzytimetrans(86400)\fR returns 1.0 day
.PP
\&\fIfuzzytimetrans(86488)\fR returns 1.0 day
.PP
\&\fIfuzzytimetrans(715000)\fR returns 1.2 weeks
.PP
\&\fIfuzzytimetrans(720000)\fR returns 1.2 weeks
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright 2004\-2012 \s-1SPARTA\s0, Inc.  All rights reserved.
See the \s-1COPYING\s0 file included with the DNSSEC-Tools package for details.
.SH "AUTHOR"
.IX Header "AUTHOR"
Wayne Morrison, tewok@tislabs.com
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fB\f(BItimetrans\fB\|(1)\fR