Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

gotime

package module

Go to main page

Versions in this module

v0

v0.6.3

Jun 4, 2026

v0.6.2

May 28, 2026

v0.6.1

May 21, 2026

v0.1.0

May 16, 2026

Changes in this version

+ const Hour

+ const Microsecond

+ const Millisecond

+ const Minute

+ const Nanosecond

+ const Second

+ var ErrAmbiguousDate = errors.New("gotime: ambiguous date")

+ var ErrAmbiguousTime = errors.New("gotime: ambiguous time")

+ var ErrAmbiguousZone = errors.New("gotime: ambiguous zone")

+ var ErrDuplicateTime = errors.New("gotime: duplicate local time")

+ var ErrEmptyInput = errors.New("gotime: empty input")

+ var ErrIncompatibleTypes = errors.New("gotime: incompatible types")

+ var ErrIntervalReversed = errors.New("gotime: interval end before start")

+ var ErrIntervalsDisjoint = errors.New("gotime: intervals disjoint")

+ var ErrInvalidDate = errors.New("gotime: invalid date")

+ var ErrInvalidDuration = errors.New("gotime: invalid duration")

+ var ErrInvalidFormat = errors.New("gotime: invalid format")

+ var ErrInvalidPeriod = errors.New("gotime: invalid period")

+ var ErrInvalidTime = errors.New("gotime: invalid time")

+ var ErrInvalidZone = errors.New("gotime: invalid zone")

+ var ErrNonexistentTime = errors.New("gotime: nonexistent local time")

+ var ErrOverflow = errors.New("gotime: overflow")

+ var ErrUnparseable = errors.New("gotime: unparseable")

+ func Zones() []string

+ type Date struct

+ func DateFromTime(t time.Time) Date

+ func NewDate(year int, month time.Month, day int) (Date, error)

+ func ParseDate(input string, opts ...Option) (Date, error)

+ func TodayIn(z Zone) Date

+ func (d *Date) UnmarshalJSON(b []byte) error

+ func (d Date) Add(p Period) Date

+ func (d Date) After(other Date) bool

+ func (d Date) Before(other Date) bool

+ func (d Date) Compare(other Date) int

+ func (d Date) Day() int

+ func (d Date) DaysInMonth() int

+ func (d Date) Equal(other Date) bool

+ func (d Date) ISOWeek() (year, week int)

+ func (d Date) IsLeapYear() bool

+ func (d Date) IsZero() bool

+ func (d Date) MarshalJSON() ([]byte, error)

+ func (d Date) Month() time.Month

+ func (d Date) Std(z Zone) time.Time

+ func (d Date) String() string

+ func (d Date) Sub(other Date) Period

+ func (d Date) Weekday() time.Weekday

+ func (d Date) Year() int

+ func (d Date) YearDay() int

+ type DateTime struct

+ func DateTimeFromTime(t time.Time, z Zone) DateTime

+ func NewDateTime(d Date, t Time, z Zone) (DateTime, error)

+ func NowIn(z Zone) DateTime

+ func ParseDateTime(input string, opts ...Option) (DateTime, error)

+ func (dt *DateTime) UnmarshalJSON(b []byte) error

+ func (dt DateTime) Add(d Duration) DateTime

+ func (dt DateTime) AddPeriod(p Period) DateTime

+ func (dt DateTime) After(other DateTime) bool

+ func (dt DateTime) Before(other DateTime) bool

+ func (dt DateTime) Clock() Time

+ func (dt DateTime) Compare(other DateTime) int

+ func (dt DateTime) Date() Date

+ func (dt DateTime) Equal(other DateTime) bool

+ func (dt DateTime) In(z Zone) DateTime

+ func (dt DateTime) Instant() Instant

+ func (dt DateTime) IsZero() bool

+ func (dt DateTime) MarshalJSON() ([]byte, error)

+ func (dt DateTime) Std() time.Time

+ func (dt DateTime) String() string

+ func (dt DateTime) Sub(other DateTime) Duration

+ func (dt DateTime) Zone() Zone

+ type Duration time.Duration

+ func ParseDuration(input string, opts ...Option) (Duration, error)

+ func (d *Duration) UnmarshalJSON(b []byte) error

+ func (d Duration) Abs() Duration

+ func (d Duration) Decompose() DurationComponents

+ func (d Duration) ISO8601() string

+ func (d Duration) InHours() float64

+ func (d Duration) InMinutes() float64

+ func (d Duration) InSeconds() float64

+ func (d Duration) IsNegative() bool

+ func (d Duration) IsZero() bool

+ func (d Duration) MarshalJSON() ([]byte, error)

+ func (d Duration) Milliseconds() int64

+ func (d Duration) Nanoseconds() int64

+ func (d Duration) RFC5545() string

+ func (d Duration) Std() time.Duration

+ func (d Duration) String() string

+ type DurationComponents struct

+ Hours int64

+ Microseconds int64

+ Milliseconds int64

+ Minutes int64

+ Nanoseconds int64

+ Seconds int64

+ type ErrorCode string

+ const CodeAmbiguousDate

+ const CodeAmbiguousTime

+ const CodeAmbiguousZone

+ const CodeDuplicateTime

+ const CodeEmptyInput

+ const CodeIncompatibleTypes

+ const CodeIntervalReversed

+ const CodeIntervalsDisjoint

+ const CodeInvalidDate

+ const CodeInvalidDuration

+ const CodeInvalidFormat

+ const CodeInvalidPeriod

+ const CodeInvalidTime

+ const CodeInvalidZone

+ const CodeNonexistentTime

+ const CodeOverflow

+ const CodeUnparseable

+ type Instant struct

+ func InstantFromTime(t time.Time) Instant

+ func Now() Instant

+ func ParseInstant(input string, opts ...Option) (Instant, error)

+ func UnixMillis(ms int64) Instant

+ func UnixNanos(ns int64) Instant

+ func UnixSeconds(s int64) Instant

+ func (i *Instant) UnmarshalJSON(b []byte) error

+ func (i Instant) Add(d Duration) Instant

+ func (i Instant) After(other Instant) bool

+ func (i Instant) Before(other Instant) bool

+ func (i Instant) Compare(other Instant) int

+ func (i Instant) Equal(other Instant) bool

+ func (i Instant) In(z Zone) DateTime

+ func (i Instant) IsZero() bool

+ func (i Instant) MarshalJSON() ([]byte, error)

+ func (i Instant) Std() time.Time

+ func (i Instant) String() string

+ func (i Instant) Sub(other Instant) Duration

+ func (i Instant) UnixMilli() int64

+ func (i Instant) UnixNano() int64

+ type Interval struct

+ func IntervalOf(start Instant, d Duration) Interval

+ func NewInterval(start, end Instant) (Interval, error)

+ func ParseInterval(input string, opts ...Option) (Interval, error)

+ func (iv *Interval) UnmarshalJSON(b []byte) error

+ func (iv Interval) Adjacent(other Interval) bool

+ func (iv Interval) Contains(i Instant) bool

+ func (iv Interval) End() Instant

+ func (iv Interval) Expand(before, after Duration) Interval

+ func (iv Interval) Intersect(other Interval) (Interval, bool)

+ func (iv Interval) IsZero() bool

+ func (iv Interval) Length() Duration

+ func (iv Interval) MarshalJSON() ([]byte, error)

+ func (iv Interval) Overlaps(other Interval) bool

+ func (iv Interval) Shift(d Duration) Interval

+ func (iv Interval) Start() Instant

+ func (iv Interval) StdRange() (start, end time.Time)

+ func (iv Interval) String() string

+ func (iv Interval) Union(other Interval) (Interval, error)

+ type Kind string

+ const KindDate

+ const KindDateTime

+ const KindDuration

+ const KindInstant

+ const KindInterval

+ const KindPeriod

+ const KindTime

+ type Option func(*config)

+ func WithInputLocale(tag language.Tag) Option

+ func WithReference(t Instant) Option

+ func WithZone(zone Zone) Option

+ type ParseResult struct

+ Candidates []ParseResult

+ Error *TimeError

+ HasZone bool

+ Input string

+ Kind Kind

+ Reference Instant

+ Status Status

+ Warnings []Warning

+ Zone Zone

+ func Parse(input string, opts ...Option) ParseResult

+ func (r ParseResult) Date() (Date, bool)

+ func (r ParseResult) DateTime() (DateTime, bool)

+ func (r ParseResult) Duration() (Duration, bool)

+ func (r ParseResult) Instant() (Instant, bool)

+ func (r ParseResult) Interval() (Interval, bool)

+ func (r ParseResult) MarshalJSON() ([]byte, error)

+ func (r ParseResult) Period() (Period, bool)

+ func (r ParseResult) Time() (Time, bool)

+ func (r ParseResult) Value() any

+ type Period struct

+ Days int32

+ Months int32

+ Years int32

+ func Days(n int) Period

+ func Months(n int) Period

+ func ParsePeriod(input string, opts ...Option) (Period, error)

+ func Years(n int) Period

+ func (p *Period) UnmarshalJSON(b []byte) error

+ func (p Period) Abs() Period

+ func (p Period) Add(other Period) Period

+ func (p Period) ISO8601() string

+ func (p Period) IsNegative() bool

+ func (p Period) IsZero() bool

+ func (p Period) MarshalJSON() ([]byte, error)

+ func (p Period) Negate() Period

+ func (p Period) RFC5545() string

+ func (p Period) String() string

+ func (p Period) Sub(other Period) Period

+ type Status string

+ const StatusAmbiguous

+ const StatusInvalid

+ const StatusResolved

+ type Time struct

+ func NewTime(hour, minute, second int) (Time, error)

+ func NewTimeNanos(hour, minute, second, nanosecond int) (Time, error)

+ func ParseTime(input string, opts ...Option) (Time, error)

+ func TimeFromTime(t time.Time) Time

+ func (t *Time) UnmarshalJSON(b []byte) error

+ func (t Time) After(other Time) bool

+ func (t Time) Before(other Time) bool

+ func (t Time) Equal(other Time) bool

+ func (t Time) Hour() int

+ func (t Time) IsZero() bool

+ func (t Time) MarshalJSON() ([]byte, error)

+ func (t Time) Minute() int

+ func (t Time) Nanosecond() int

+ func (t Time) Second() int

+ func (t Time) Std(on Date, z Zone) time.Time

+ func (t Time) String() string

+ type TimeError struct

+ Code ErrorCode

+ Err error

+ Hint string

+ Input string

+ Message string

+ func (e *TimeError) Error() string

+ func (e *TimeError) Unwrap() error

+ type Warning struct

+ Code WarningCode

+ Hint string

+ Message string

+ type WarningCode string

+ const WarnAssumedZone

+ const WarnDuplicateTime

+ const WarnInferredCalendar

+ const WarnTruncatedPrecision

+ type Zone struct

+ var Local Zone

+ var UTC Zone

+ func LoadZone(id string) (Zone, error)

+ func MustLoadZone(id string) Zone

+ func ResolveZone(id string) (Zone, error)

+ func (z *Zone) UnmarshalJSON(b []byte) error

+ func (z Zone) Abbreviation(i Instant) string

+ func (z Zone) Equal(other Zone) bool

+ func (z Zone) ID() string

+ func (z Zone) IsDST(i Instant) bool

+ func (z Zone) IsZero() bool

+ func (z Zone) Location() *time.Location

+ func (z Zone) MarshalJSON() ([]byte, error)

+ func (z Zone) OffsetAt(i Instant) string

+ func (z Zone) Snapshot(i Instant) ZoneSnapshot

+ func (z Zone) String() string

+ type ZoneSnapshot struct

+ Abbreviation string

+ DST bool

+ ID string

+ Offset string