gogcli/docs/dates.md
Ross Sivertsen - Systems Sherpa 077f9a3620
contacts: support --birthday and --notes in contacts update (#233)
* contacts: allow updating birthday and notes

* fix(cli): unify date parsing + cover contacts birthday/notes (#233) (thanks @rosssivertsen)

---------

Co-authored-by: Ross Sivertsen <ross@canyoncreek.co>
Co-authored-by: Peter Steinberger <steipete@gmail.com>
2026-02-13 18:16:49 +01:00

999 B

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.