timetrans(3)

📦
version 2.2.3 · 3 versions
, in arch rolling

💖 timetrans(3) — Net::DNS::SEC::Tools::timetrans 💖

okay bestie, so this is a page from User Contributed Perl Documentation, and it's literally the timetrans(3) man page. it's giving "small module, big 'how many days is that actually' energy" and honestly? we stan a unit converter. 🕐✨

🌸 NAME 🌸

Net::DNS::SEC::Tools::timetrans — turns an integer seconds count into text units. that's it, that's the whole gig. no cap. 💅

🦋 SYNOPSIS 🦋

use Net::DNS::SEC::Tools::timetrans;

$timestring = timetrans(86488);

$timestring = fuzzytimetrans(86488);

two functions, one use line, we love a low-maintenance import. 🎀

✨ DESCRIPTION ✨

so the timetrans() interface in Net::DNS::SEC::Tools::timetrans takes an integer seconds count and converts it into the equivalent number of days, hours, and minutes. key detail bestie: the time converted is a relative time, not an absolute time. it's a duration, not a timestamp, iykyk. ⏳

the returned time comes back in terms of days, hours, minutes, and seconds — exactly as many of those as are needed to express the seconds count appropriately. so like, don't expect it to pad out all four if it doesn't need to.

then there's fuzzytimetrans(), the chill one 😌 — it converts an integer seconds count into the equivalent number of weeks or days or hours or minutes. whichever unit is most natural for that seconds count gets picked. and it includes one decimal place of precision in the result. so you get the vibe, not the exact receipts. 📊

🌈 INTERFACES 🌈

the interfaces to the Net::DNS::SEC::Tools::timetrans module are given below. let's get into it 🫶

🎀 timetrans()

this routine converts an integer seconds count into the equivalent number of days, hours, and minutes. the converted seconds count gets returned as a text string. heads up though: the seconds count must be greater than zero, or an error will be returned. 🚨

Return Values:

  • 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. (yes, that includes zero. zero is not invited to this party. 🙈)

🧚 fuzzytimetrans()

this routine converts an integer seconds count into the equivalent number of weeks, days, hours, or minutes. the converted seconds count gets returned as a text string. same rule applies: the seconds count must be greater than zero, or an error will be returned. ⚠️

Return Values:

  • 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. same energy as above, fr fr.

🔥 EXAMPLES 🔥

okay this is the fun part, watch the conversions go off 👑

timetrans(400) returns 6 minutes, 40 seconds
timetrans(420) returns 7 minutes
timetrans(888) returns 14 minutes, 48 seconds
timetrans(86400) returns 1 day
timetrans(86488) returns 1 day, 28 seconds
timetrans(715000) returns 8 days, 6 hours, 36 minutes, 40 second
timetrans(720000) returns 8 days, 8 hours

and now the fuzzy icons, serving rounded decimals 🍓

fuzzytimetrans(400) returns 6.7 minutes
fuzzytimetrans(420) returns 7.0 minutes
fuzzytimetrans(888) returns 14.8 minutes
fuzzytimetrans(86400) returns 1.0 day
fuzzytimetrans(86488) returns 1.0 day
fuzzytimetrans(715000) returns 1.2 weeks
fuzzytimetrans(720000) returns 1.2 weeks
and yeah, 40 second is singular up there in the 715000 example — that's exactly how it's written, bestie. not a typo on my end, that's the source being the source. 💀

Copyright 2004-2014 SPARTA, Inc. All rights reserved. for the details, see the COPYING file included with the DNSSEC-Tools package. legal stuff, but make it cute. 📜

💫 AUTHOR 💫

Wayne Morrison, tewok@tislabs.com — shoutout to the main character who wrote this. 🌟

💅 SEE ALSO 💅

mwah 💋 that's the whole page! this one shipped as perl v5.44.0, dated 2026-10-17 — go forth and convert your seconds, bestie, the units are waiting 🦋✨🎀

📦 where this page comes from