TIMEW-DATES(7)

💖 TIMEW-DATES(7) — User Manuals 💖

Okay bestie, this is the timew-dates page: date formats supported by Timewarrior. It’s giving ISO-8601 main character energy, and we’re gonna go through every single format together. 🫶

🌸 NAME 🌸

timew-dates — date formats supported by Timewarrior

✨ SYNOPSIS ✨

The original SYNOPSIS is literally empty, bestie — this page is a reference for date formats, not a command invocation.

💅 DESCRIPTION 💅

Timewarrior supports the following datetime formats based on ISO-8601. If times are followed by a 'Z', they are assumed to be in UTC, otherwise local time (TZ) is assumed.

<extended-date> [T <extended-time>]   Extended date, optional extended time
<date> [T <time>]                     Date, optional time
<extended-time>                       Extended time
<time>                                Time

🦋 extended-date 🦋

• YYYY-MM-DD — Year, month, day
• YYYY-MM — Year, month, 1st
• YYYY-DDD — Year, Julian day 001-366
• YYYY-WwwD — Year, week number, day number
• YYYY-Www — Year, week number, day 1

🦋 extended-time 🦋

• hh:mm[:ss]Z — Hours, minutes, optional seconds, UTC
• hh:mm[:ss][+/-hh:mm] — Hours, minutes, optional seconds, TZ

🦋 date 🦋

• YYYYMMDD — Year, month, day
• YYYYWww — Year, week number, day number
• YYYYDDD — Year, Julian day 001-366

🦋 time 🦋

• hhmm[ss]Z — Hour, minutes, optional seconds, UTC
• hhmm[ss][+/-hh[mm]] — Hour, minutes, optional seconds, TZ

🎀 EXAMPLES 🎀

Here are some examples for ISO datetimes:

2016-06-09T08:12:00Z
2016-06T08:12:00+01:00
2016-06T08:12Z
2016-161
2016-W244
2016-W24
20160609T081200Z
2016W24
8:12:00Z
0812-0500

In addition to the standard date formats, the following named dates are supported:

🌟 named dates 🌟

• now — Current date and time
• today — Current date at 0:00:00
• yesterday — Yesterday at 0:00:00
• tomorrow — Tomorrow at 0:00:00 (midnight tonight)
• <day-of-week> — Previous named day at 0:00:00
• <month-of-year> — Previous 1st of the month at 0:00:00
• hh:mm[:ss][am|a|pm|p] — Short time format
• Nst, Nnd, Nrd, Nth — Previous 1st, 2nd, 3rd ...
• <epoch> — POSIX time (at least 315532800)
• later — 2038-01-18T0:00:00 (Y2K38)
• someday — 2038-01-18T0:00:00 (Y2K38)
• sopd, eopd — Start/end of previous day
• sod, eod — Start/end of current day
• sond, eond — Start/end of next day
• sopw, eopw — Start/end of previous week
• sow, eow — Start/end of current week
• sonw, eonw — Start/end of next week
• sopww, eopww — Start/end of previous work week (mon - fri)
• soww, eoww — Start/end of current work week (mon - fri)
• sonww, eonww — Start/end of next work week (mon - fri)
• sopm, eopm — Start/end of previous month
• som, eom — Start/end of current month
• sonm, eonm — Start/end of next month
• sopq, eopq — Start/end of previous quarter
• soq, eoq — Start/end of current quarter
• sonq, eonq — Start/end of next quarter
• sopy, eopy — Start/end of previous year
• soy, eoy — Start/end of current year
• sony, eony — Start/end of next year
• easter — Easter Sunday
• eastermonday — Easter Monday
• ascension — Ascension
• pentecost — Pentecost
• goodfriday — Good Friday
• midsommar — midnight, 1st Saturday after 20th June
• midsommarafton — midnight, 1st Friday after 19th June
• juhannus — midnight, 1st Friday after 19th June

For times, the following are also possible:

• 8am
• 24th
• monday
• august

🫶 NOTES 🫶

Okay, important caveat time. The minimum value for the POSIX time format of 315532800 (that is 1980-01-01) was chosen to avoid confusion with ISO dates in the YYYYMMDD format.

Because named dates are defined with time 0:00:00, using them as range end excludes the respective day. E.g. using 'today' as upper range

$ timew sum 2d before today

will not show any intervals of the current day. Use either 'now' or 'tomorrow' in this case:

$ timew sum 2d before now
$ timew sum 2d before tomorrow

🌈 SEE ALSO 🌈

timew-durations(7), timew-hints(7) — go read these next, bestie.

---

💖 That’s the whole page — brought to you by timew 1.9.1, dated 2025-11-02, and it’s literally TIMEW-DATES(7). Periodt. 💖