​

Date and Time Input Formats

Use one parsing contract across commands.

​

Canonical choices

• Prefer RFC3339 in automation: 2026-02-13T15:04:05Z
• Use YYYY-MM-DD for date-only fields (birthdays, date-only due values)
• Keep timezone explicit when time matters

​

Accepted input formats

• Date-only: YYYY-MM-DD
• Datetime: RFC3339 / RFC3339Nano
• ISO offset without colon: YYYY-MM-DDTHH:MM:SS-0800
• Local datetime (no timezone):
  • YYYY-MM-DDTHH:MM[:SS]
  • YYYY-MM-DD HH:MM[:SS]

​

Relative forms

Calendar range flags (--from / --to) also accept:

• now, today, tomorrow, yesterday
• Weekday names: monday, next friday

​

Duration forms

Tracking --since also accepts time.ParseDuration values such as:

• 24h
• 15m

​

Agent guidance

• Generate RFC3339 for all datetime fields by default.
• Use date-only for fields explicitly documented as dates.
• For local scheduling, pass an explicit offset (or timezone-aware RFC3339) to avoid ambiguity.