clocktime/README.md

clocktime

clocktime provides a type that holds a calendar-independent time of day value in 24-hour format.

clocktime provides basic types that extend Go's built-in time.Time to provide time-of-day and duration support.

`clocktime.ClockTime

Holds calendar-independent time-of-day in 24-hour format.

• Converts to and from HH:MM:SS format (subset of ISO8061)
• Marshals to []byte containing string HH:MM:SS for SQL
• Marshals to string in format HH:MM:SS for JSON & gqlgen

clocktime.Duration

Wraps time.Duration with prioritized ISO8061 support and opinionated marshalling.

• Converts to and from ISO8061 format (utilises sosodev/duration)
• Marshals to uint64 with nanosecond precision. Largest representatable duration is about 290 years, limited by underlying time.Duration type.
• Marshals to string in ISO8061 format for JSON & gqlgen