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

time

package module

Go to main page

Versions in this module

v0

v0.2.0

Jul 23, 2025

Changes in this version

+ var FixedZone = time.FixedZone

+ var UTC = time.UTC

+ func After(ctx context.Context, d Duration) <-chan time.Time

+ func Dur(f func()) time.Duration

type Clock

+ func FromContext(ctx context.Context) Clock

+ func TryFromContext(ctx context.Context) Clock

+ type MockClockOption = internal.MockClockOption

+ func YieldTime(d time.Duration) MockClockOption

v0.1.1

Apr 2, 2025

v0.1.0

Apr 2, 2025

Changes in this version

+ const ANSIC

+ const DateOnly

+ const DateTime

+ const Day

+ const Hour

+ const Kitchen

+ const Layout

+ const Microsecond

+ const Millisecond

+ const Minute

+ const Nanosecond

+ const RFC1123

+ const RFC1123Z

+ const RFC3339

+ const RFC3339Nano

+ const RFC822

+ const RFC822Z

+ const RFC850

+ const RubyDate

+ const Second

+ const Stamp

+ const StampMicro

+ const StampMilli

+ const StampNano

+ const TimeOnly

+ const UnixDate

+ const Week

+ var Date = time.Date

+ var ErrClockAlreadyExists = errors.New("clock already exists")

+ var ErrClockIsRunning = errors.New("clock is running")

+ var ErrClockNotRunning = errors.New("clock is stopped")

+ var ErrNotADelorean = errors.New("not a DeLorean clock (cannot go back in time)")

+ var Parse = time.Parse

+ var ParseDuration = time.ParseDuration

+ var ParseInLocation = time.ParseInLocation

+ var Unix = time.Unix

+ var UnixMicro = time.UnixMicro

+ var UnixMilli = time.UnixMilli

+ func ContextWithClock(ctx context.Context, c Clock) context.Context

+ func ContextWithDeadline(ctx context.Context, t time.Time) (context.Context, context.CancelFunc)

+ func ContextWithDeadlineCause(ctx context.Context, t time.Time, cause error) (context.Context, context.CancelFunc)

+ func ContextWithTimeout(ctx context.Context, d time.Duration) (context.Context, context.CancelFunc)

+ func ContextWithTimeoutCause(ctx context.Context, d time.Duration, cause error) (context.Context, context.CancelFunc)

+ func Sleep(ctx context.Context, d Duration)

+ func Tick(ctx context.Context, d Duration) <-chan Time

+ type Clock interface

+ After func(d time.Duration) <-chan time.Time

+ AfterFunc func(d time.Duration, f func()) *Timer

+ ContextWithDeadline func(ctx context.Context, d time.Time) (context.Context, context.CancelFunc)

+ ContextWithDeadlineCause func(ctx context.Context, d time.Time, cause error) (context.Context, context.CancelFunc)

+ ContextWithTimeout func(ctx context.Context, d time.Duration) (context.Context, context.CancelFunc)

+ ContextWithTimeoutCause func(ctx context.Context, d time.Duration, cause error) (context.Context, context.CancelFunc)

+ NewTicker func(d time.Duration) *Ticker

+ NewTimer func(d time.Duration) *Timer

+ Now func() time.Time

+ Since func(t time.Time) time.Duration

+ Sleep func(d time.Duration)

+ Tick func(d time.Duration) <-chan time.Time

+ Until func(t time.Time) time.Duration

+ func ClockFromContext(ctx context.Context) Clock

+ func SystemClock() Clock

+ func TryClockFromContext(ctx context.Context) Clock

+ type ClockOption func(*mockClock)

+ func AtNow() ClockOption

+ func AtTime(t time.Time) ClockOption

+ func DropsTicks() ClockOption

+ func InLocation(loc *time.Location) ClockOption

+ func StartRunning() ClockOption

+ func Yielding(d time.Duration) ClockOption

+ type Duration = time.Duration

+ type Location = time.Location

+ type MockClock interface

+ AdvanceBy func(d time.Duration)

+ AdvanceTo func(t time.Time)

+ CreatedAt func() time.Time

+ IsRunning func() bool

+ SinceCreated func() time.Duration

+ Start func()

+ Stop func()

+ Update func()

+ func ContextWithMockClock(parent context.Context, opts ...ClockOption) (context.Context, MockClock)

+ func NewMockClock(options ...ClockOption) MockClock

+ type Month = time.Month

+ type ParseError = time.ParseError

+ type Ticker struct

+ func NewTicker(ctx context.Context, d Duration) *Ticker

+ func (t *Ticker) Reset(d time.Duration)

+ func (t *Ticker) Stop()

+ type Time = time.Time

+ func Now(ctx context.Context) Time

+ type Timer struct

+ func AfterFunc(ctx context.Context, d Duration, f func()) *Timer

+ func NewTimer(ctx context.Context, d Duration) *Timer

+ func (t *Timer) Reset(d time.Duration) bool

+ func (t *Timer) Stop() bool

+ type Weekday = time.Weekday