Convert periods such as last month, this quarter, or the past 45 days into explicit date ranges. Get local dates and exact UTC boundaries in readable text or JSON for time-based searches and reports.
Resolve ANY named time window — today, yesterday, thisWeek, lastWeek, last7Days, last30Days, last90Days, thisMonth, lastMonth, thisQuarter, lastQuarter, thisYear, lastYear, last12Months — or an arbitrary range (lastNdays / lastNweeks / lastNmonths) to a concrete ISO date range relative to your run time. Read-only: no writes, no network. Use whenever a task is time-scoped and you need exact start/end dates without computing them by hand.
Review the instructions the agent will receive before you install.
This is the single source of truth for "what dates does <window> mean right
now?". It resolves named windows to concrete ISO date ranges relative to your
run time (new Date() at the moment you invoke it), so you never re-derive
dates manually. It only reads the clock and prints — no files written, no network.
# all windows at once (a quick temporal-context dump)
node "$AGENT_DIR/.claude/skills/temporal/when.mjs"
# one or several specific windows
node "$AGENT_DIR/.claude/skills/temporal/when.mjs" last30Days thisQuarter
# JSON only (machine-readable), or list the supported keywords
node "$AGENT_DIR/.claude/skills/temporal/when.mjs" --json last7Days
node "$AGENT_DIR/.claude/skills/temporal/when.mjs" --list
If $AGENT_DIR is somehow unset, the script also lives under
~/.claude/skills/temporal/when.mjs.
| Keyword | Meaning |
|---|---|
today / yesterday | the single civil day |
thisWeek / lastWeek | ISO week (Mon-start); this = Mon→today, last = the full prior Mon→Sun |
last7Days / last30Days / last90Days | rolling N-day window ending today (inclusive) |
thisMonth / lastMonth | this = 1st→today; last = the full prior calendar month |
thisQuarter / lastQuarter | this = quarter-start→today; last = the full prior quarter |
thisYear / lastYear | this = Jan 1→today (YTD); last = the full prior year |
last12Months | rolling 12 months ending today |
lastNdays / lastNweeks / lastNmonths | arbitrary rolling window, e.g. last45days, last2weeks, last6months |
Aliases: ytd, qtd, mtd, wtd, 7d, 30d, 90d, 12m.
Convention: this* windows are period-start → today (to-date); last*
named periods are the full prior complete period.
Each window prints a human line plus a JSON record:
start / end — inclusive civil dates (YYYY-MM-DD) in your local timezonestartUtc / endExclusiveUtc — the same span as a half-open [start, end)
range of exact UTC instants, ideal for timestamp / createdAt-style queriesdays, inclusive, timezone, tzOffsetMinutes, asOf — span, tz, and the
instant the range was resolvedUse the returned dates as the time bounds for the task. The named shortcuts
/today, /yesterday, /last30Days, /lastQuarter, … each call this same
resolver for their one window.
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Help a spawned worker check which date-range helpers and external integrations are available and how to call them. The catalog explains environment settings, local broker access, and availability checks so the worker can choose tools for its task.
Plan and generate hand-drawn article illustrations that turn key ideas, processes, and metaphors into clear visual scenes. The skill suggests image placement, creates individual 16:9 images with an active central character, and checks composition and annotations.
Resolve the last 30 days, including today, into local calendar dates and exact UTC time boundaries. Use the text and JSON output to scope trend analysis or recent activity reviews without manual date calculations or network access.
Turn “last seven days” into a concrete date range ending today. Get local calendar dates and precise UTC boundaries, the global time reference, to use as consistent limits for reports or timestamp searches.
Turn “last month” into the full previous calendar month's date range. Get local calendar dates and precise UTC boundaries, the global time reference, to set consistent periods for monthly reports, summaries, or timestamp searches.
Get the date range for the previous full quarter, based on when the skill runs. It returns local dates and precise UTC boundaries to define reporting periods for quarterly reviews, quarter-over-quarter comparisons, and timestamp-based queries.