timefmt

Documentation

Index

• Constants
• func Parse(input string) (string, error)
• func ParseEnd(input string) (string, error)

Constants

const APILayout = "2006-01-02T15:04:05.000-0700"

APILayout is the time format the Cubox API expects.

Functions

func Parse

func Parse(input string) (string, error)

Parse converts a human-friendly time string to the Cubox API format. Day-level shortcuts (today, yesterday, 7d, date-only) resolve to the start of the day (00:00:00.000). Use ParseEnd for end-time semantics.

Accepted inputs:

"today"                            → start of today (00:00:00.000)
"yesterday"                        → start of yesterday
"now"                              → current instant
"7d" / "-7d"                       → 7 days ago at 00:00
"2026-04-09"                       → date only, midnight local time
"2026-04-09 17:12"                 → date + hour:minute
"2026-04-09 17:12:48"              → date + time
"2026-04-09T17:12:48"              → ISO-style date + time
"2026-04-09T17:12:48.695+0800"     → full precision
"2026-04-09T17:12:48.695+08:00"    → full precision with colon tz

func ParseEnd

func ParseEnd(input string) (string, error)

ParseEnd is like Parse but resolves day-level inputs to end-of-day (23:59:59.999) instead of midnight. Use this for --end-time parameters so that "today" covers the entire day rather than just its first instant.