years

Oct 26, 2026

Changes in this version

type ParserOption

+ func WithLocation(loc *time.Location) ParserOption

+ func WithWeekStart(d time.Weekday) ParserOption

+ func WithWorkdays(days ...time.Weekday) ParserOption

Jul 19, 2026

Changes in this version

type Parser

+ func (p *Parser) JustParsePeriod(value string) (Period, error)

+ func (p *Parser) ParsePeriod(layout string, value string) (Period, error)

type ParserOption

+ func AcceptRelativeOffsets() ParserOption

+ type Period struct

+ End time.Time

+ Start time.Time

+ func InstantPeriod(t time.Time) Period

+ func JustParsePeriod(value string) (Period, error)

+ func ParsePeriod(layout string, value string) (Period, error)

+ func (p Period) Contains(t time.Time) bool

+ func (p Period) Duration() time.Duration

+ func (p Period) IsInstant() bool

+ func (p Period) IsZero() bool

Jun 28, 2026

Changes in this version

+ var DefaultLayouts = []string

Jun 28, 2026

Changes in this version

+ const LayoutDate

+ const LayoutDateTime

+ const LayoutDateTimeShort

+ const LayoutHuman

+ const LayoutHumanDate

+ var ErrInvalidISODuration = errors.New("invalid ISO-8601 duration")

+ func Format(t time.Time, layout string) string

+ func FormatDurationClock(d time.Duration) string

+ func FormatPtr(t *time.Time, layout string) string

+ func Humanize(t time.Time) string

+ func HumanizeDuration(d time.Duration) string

+ func HumanizeFrom(base, t time.Time) string

+ func ParseISODuration(s string) (time.Duration, error)

Jun 26, 2026

Changes in this version

+ func Now() time.Time

type MutatingTime

+ func (mt *MutatingTime) TruncateToHour() *MutatingTime

+ func (mt *MutatingTime) TruncateToMinute() *MutatingTime

+ func (mt *MutatingTime) TruncateToMonth() *MutatingTime

+ func (mt *MutatingTime) TruncateToSecond() *MutatingTime

+ func (mt *MutatingTime) TruncateToWeek(weekStartsOn time.Weekday) *MutatingTime

+ func (mt *MutatingTime) TruncateToYear() *MutatingTime

May 1, 2025

Changes in this version

+ func JustParseRaw(value any) (time.Time, error)

type MutatingTime

+ func (mt *MutatingTime) SetMillisecond(ms int) *MutatingTime

Apr 28, 2025

Changes in this version

type Parser

+ func (p *Parser) ParseEpoch(v int64) (time.Time, bool, error)

Apr 26, 2025

Changes in this version

+ func JustParse(value string) (time.Time, error)

type Parser

+ func (p *Parser) DigitsAsTimestamp(unixDigits int64) time.Time

Jun 8, 2024

Changes in this version

+ const LayoutFormatGo

+ const LayoutFormatUndefined

+ const LayoutFormatUnixTimestamp

+ const LayoutTimestampMicroseconds

+ const LayoutTimestampMilliseconds

+ const LayoutTimestampNanoseconds

+ const LayoutTimestampSeconds

+ var DateUnitsDict = struct{ ... }

+ var DefaultParser = func() *Parser

+ var LayoutFormatDict = struct{ ... }

+ func ExtendParserDefaults(opts ...ParserOption)

+ func Parse(layout string, value string) (time.Time, error)

+ func ResetParserDefaults()

+ func SetParserDefaults(opts ...ParserOption)

+ func SetStdClock(c Clock)

+ type Clock interface

+ Now func() time.Time

+ type DateUnit int

+ const Day

+ const Month

+ const Quarter

+ const UnitUndefined

+ const UnixMicrosecond

+ const UnixMillisecond

+ const UnixNanosecond

+ const UnixSecond

+ const Week

+ const Year

+ func (du DateUnit) Defined() bool

+ func (du DateUnit) String() string

+ type LayoutDetails struct

+ Format LayoutFormat

+ MinimalUnit DateUnit

+ Units []DateUnit

+ func ParseLayout(layout string) *LayoutDetails

+ func (lm *LayoutDetails) HasUnit(q DateUnit) bool

+ type LayoutFormat int

+ func (lf LayoutFormat) String() string

+ type MutatingTime struct

+ func Mutate(v *time.Time) *MutatingTime

+ func (t *MutatingTime) SetDay(day int) *MutatingTime

+ func (t *MutatingTime) SetHour(hour int) *MutatingTime

+ func (t *MutatingTime) SetMinute(minute int) *MutatingTime

+ func (t *MutatingTime) SetMonth(month time.Month) *MutatingTime

+ func (t *MutatingTime) SetNanosecond(nanosecond int) *MutatingTime

+ func (t *MutatingTime) SetSecond(second int) *MutatingTime

+ func (t *MutatingTime) SetYear(v int) *MutatingTime

+ func (t *MutatingTime) Time() time.Time

+ func (t *MutatingTime) TruncateToDay() *MutatingTime

+ type Parser struct

+ func NewParser(options ...ParserOption) *Parser

+ func (p *Parser) JustParse(value string) (time.Time, error)

+ func (p *Parser) Parse(layout string, value string) (time.Time, error)

+ func (p *Parser) ParseAsTimestamp(value string) (time.Time, error)

+ type ParserOption func(*Parser)

+ func AcceptAliases() ParserOption

+ func AcceptUnixMicro() ParserOption

+ func AcceptUnixMilli() ParserOption

+ func AcceptUnixNano() ParserOption

+ func AcceptUnixSeconds() ParserOption

+ func GetParserDefaults() []ParserOption

+ func WithCustomAliases(customAliases map[string]func(time.Time) time.Time) ParserOption

+ func WithCustomClock(c Clock) ParserOption

+ func WithLayouts(layouts ...string) ParserOption

+ type StdClock struct

+ func (c *StdClock) Now() time.Time

+ type TimeNamedWaypointFile struct

+ func NewTimeNamedWaypointFile(path string, fullLayout string, parentArg ...*TimeNamedWaypointFile) (*TimeNamedWaypointFile, error)

+ func (w *TimeNamedWaypointFile) Time() time.Time

+ type TimeNamedWaypointFiles []*TimeNamedWaypointFile

+ type TraverseDirection string

+ const TraverseDirectionFuture

+ const TraverseDirectionPast

+ type TraverseNodesMode string

+ const TraverseAllNodes

+ const TraverseContainersOnly

+ const TraverseLeavesOnly

+ type TraverseOption func(*traverseConfig)

+ func O_ALL() TraverseOption

+ func O_CONTAINERS_ONLY() TraverseOption

+ func O_FUTURE() TraverseOption

+ func O_LEAVES_ONLY() TraverseOption

+ func O_NON_CALENDAR() TraverseOption

+ func O_PAST() TraverseOption

+ type Voyager struct

+ func NewVoyager(root Waypoint, parserArg ...*Parser) *Voyager

+ func (v *Voyager) Find(timeStr string) ([]Waypoint, error)

+ func (v *Voyager) Navigate(to string) (Waypoint, error)

+ func (v *Voyager) Traverse(cb func(w Waypoint), opts ...TraverseOption) error

+ type Waypoint interface

+ Children func() []Waypoint

+ Identifier func() string

+ IsContainer func() bool

+ Time func() time.Time

+ func AllChildren(w Waypoint) []Waypoint

+ func NewWaypointGroup(identifier string, waypoints ...Waypoint) Waypoint

+ func WaypointGroupFromStrings(timeStrings []string, layoutArg ...string) Waypoint

+ func WaypointsFromStrings(timeStrings []string, layoutArg ...string) []Waypoint

+ type WaypointFile struct

+ func NewWaypointFile(path string, timeGetter func(timeSpec times.Timespec) time.Time) (*WaypointFile, error)

+ func (w *WaypointFile) Children() []Waypoint

+ func (w *WaypointFile) Identifier() string

+ func (w *WaypointFile) IsContainer() bool

+ func (w *WaypointFile) Time() time.Time

+ type WaypointFiles []*WaypointFile

+ type WaypointGroup struct

+ func (wg *WaypointGroup) Children() []Waypoint

+ func (wg *WaypointGroup) Identifier() string

+ func (wg *WaypointGroup) IsContainer() bool

+ func (wg *WaypointGroup) Time() time.Time

+ type WaypointString struct

+ func NewWaypointString(v string, layoutArg ...string) *WaypointString

+ func (w *WaypointString) Children() []Waypoint

+ func (w *WaypointString) Identifier() string

+ func (w *WaypointString) IsContainer() bool

+ func (w *WaypointString) Time() time.Time

+ func (w *WaypointString) Voyager(parserArg ...*Parser) *Voyager

+ type WaypointStrings []*WaypointString