TIMEW-RANGES(7)

🎀 TIMEW-RANGES(7) 🎀

okay bestie, welcome to the TIMEW-RANGES(7) page from User Manuals — this is all about the date and time ranges supported by Timewarrior, and we're gonna make it make sense 💖✨

💅 NAME 💅

timew-ranges — date and time ranges supported by Timewarrior. That's the whole vibe: ranges, dates, times, tracked blocks. periodt 👑

🌸 SYNOPSIS 🌸

No separate synopsis line here, bestie — the actual interval syntax is waiting for you in DESCRIPTION. Keep scrolling, it's giving main character energy 🦋

🦋 DESCRIPTION 🦋

Okay so an interval is literally a block of time that is tracked. The syntax for specifying an interval is flexible, and may be one of these:

[from] <date>
[from] <date> to/- <date>
[from] <date> for <duration>
<duration> before/after <date>
<duration> ago
[for] <duration>

Examples? Obsessed with these, here they are exactly:

from 9:00
from 9am - 11am
from 9:00:00 to 11:00
from 9:00 for 2h
2h after 9am
2h before 11:00
2h ago
for 2h

An interval is called 'closed' if there is both a start date and an end date, and 'open' if there is no end date. That's it — closed has both ends, open has no end date, no cap 💫

There is also a number of useful hints for common ranges. Cute, right? Those live over in the hints page, iykyk 🫶

💜 SEE ALSO 💜

• timew-hints(7) — go read it bestie, it's right there 🌈

---

cute little sign-off time 🎀 This is timew 1.9.1, dated 2025-11-02 — thanks for reading the TIMEW-RANGES(7) page, bestie. Slay your intervals responsibly 💅✨