TIMEW-DURATIONS(7)

📦
version 1.9.1 · 9 versions
, in ubuntu resolute, ubuntu stonking

💅 TIMEW-DURATIONS(7) — like, the whole entire tea on durations

okay bestie, welcome to timew-durations, aka the section of the Timewarrior user manual that explains every single way you're allowed to write a duration. yes this is the manual page for durations, yes it's a whole page, no we're not skipping any of it 🫶

✨ NAME ✨

timew-durations — the duration formats supported by Timewarrior, periodt. that's the whole name section, she's short but she's iconic 💖

🌸 SYNOPSIS 🌸

literally nothing here. no synopsis. empty. a vibe. moving on 🎀

🦋 DESCRIPTION 🦋

so Timewarrior supports these duration formats, and they're all based on ISO-8601. here's the shape of it:

'P' [nn 'Y'] [nn 'M'] [nn 'D'] ['T' [nn 'H'] [nn 'M'] [nn 'S']]
PnnW

and here's what those look like irl ✨

  • P1Y — 1 year
  • P1.5M — 1.5 months
  • PT1S — 1 second
  • PT4.5H — 4.5 hours
  • PT4H30M — 4.5 hours
  • P600D — 600 days
  • P3W — 3 weeks
  • P1Y1DT1H1M1S — 1 year and 25 hours, 61 seconds (imprecise term)
🚨 okay this is important so listen up: the year and month terms are imprecise, being defined as 365d and 30d respectively. if you want precision, use the other terms. no cap, that's literally what it says 😭

💅 the extra formats (yes there are more, she contains multitudes)

in addition to the standard duration formats, the following are supported too:

n[.n]<unit>

where <unit> is one of these bad boys — and yes, you can spell them a bunch of different ways, we're not gonna make you memorize just one:

  • annual
  • biannual
  • bimonthly
  • biweekly
  • biyearly
  • daily
  • days, day, d
  • fortnight
  • hours, hour, hrs, hr, h
  • minutes, minute, mins, min
  • monthly, months, month, mnths, mths, mth, mos, mo, m
  • quarterly, quarters, quarter, qrtrs, qtr, q
  • semiannual
  • sennight
  • seconds, second, secs, sec, s
  • weekdays
  • weekly, weeks, week, wks, wk, w
  • yearly, years, year, yrs, yr, y

🍓 examples, because examples ate

  • 1hour — 60 minutes
  • 1.5h — 90 minutes
  • 3mo — 3 months
  • 10d — 10 days
💀 and again, one more time for the people in the back: the year, quarter and month terms are imprecise, being defined as 365d, 91d and 30d respectively. for precision use the other terms. fr fr, don't come for me when 1month isn't the exact number of days you wanted 🙈

🧚 sign-off

this absolute queen of a page is from timew version 1.9.1, dated 2025-11-02 — go forth and write your durations with confidence, bestie, you're gonna slay 💜🌈⭐

📦 where this page comes from