TIMEW-MODIFY(1)

💅 TIMEW-MODIFY — the manual page, bestie edition ✨

okay so you found timew-modify, the little command that changes the range of an interval. it's giving glow-up for your timestamps, and honestly? iconic. let's get into it 🎀

---

✨ NAME ✨

timew-modify — change the range of an interval 🌸

🌈 SYNOPSIS 🌈

timew modify (start|end) <id> <date>
timew modify range <id> <range>

💖 DESCRIPTION 💖

so the modify command is literally just there to change the range of an interval. that's the whole vibe. 🦋

with the start or end subcommand you can specify a new start date or a new end date respectively, or, using the range subcommand, you can change the complete range in one go. the interval you're modifying gets picked out by its id — that's your main character identifier, iykyk.

if the resulting interval overlaps with an existing interval, the command will return an error. rude, but fair. 💀 you can add the :adjust hint to force an overwrite in that case — more on that below, bestie.

psst — wanna know how to actually retrieve the interval id? check timew-summary(1). it's the plug. 🔥

---

🧚 HINTS 🧚

the modify command accepts the following hints:

• :fill — the :fill hint can be used instead of a date or date range to fill the gap between the interval you're modifying and its adjacent intervals. for the start and end subcommands, the :fill hint fills the gap between the targeted interval and the next or previous interval respectively. for the range subcommand, it fills gaps on both sides of the modified interval. no cap, it does the work both ways. ✨
• :adjust — the :adjust hint can be added to force the modification of the interval if it overlaps with an existing interval. this will overwrite the existing interval. 👑

---

🍓 EXAMPLES 🍓

💜 modify the start date of an interval

$ timew modify start @3 2020-12-28T17:00

this sets the start of interval '@3' to '17:00' of date '2020-12-28'. but bestie, listen — if this datetime is after the end of the interval, the command will return an error. 😭 order matters, always.

🫶 modify the end date of an interval

if the interval to be modified has the same date as today, the date can be omitted entirely:

$ timew modify end @3 18:00

similar to when modifying the interval start, the end datetime has to be after the start datetime. we love a consistent rule. 💅

⭐ modify the range of an interval

instead of modifying start and end separately, you can combine them into a single call of the range subcommand:

$ timew modify range @3 2020-12-28T17:00 - 2020-12-28T18:00

as in the examples above, the date portion can be omitted if the date of the interval is today. efficient queen behaviour. 👑

🦋 modify the range of an interval and fill gaps

$ timew modify range @3 :fill

this modifies the interval '@3' and automatically fills any gaps between this interval and its adjacent intervals. it's giving tidy. it's giving seamless. it's giving no gaps left behind. 🌈

---

🌸 SEE ALSO 🌸

timew-lengthen(1), timew-move(1), timew-resize(1), timew-shorten(1), timew-summary(1)

---

and that's the page!! this one's from timew 1.9.1, dated 2025-11-02 — go forth and modify your ranges with confidence, bestie 🫶💖