Help us shape the future of Go! Take the 2026 Go Developer Survey

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
- API
  
  Reference documentation for the pkg.go.dev API
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

clock

package

Go to main page

Versions in this module

v0

v0.5.0

Oct 20, 2026

Changes in this version

+ type Clock interface

+ NewTimer func(d time.Duration) Timer

+ Now func() time.Time

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

+ func System() Clock

+ type Fake struct

+ func NewFake(start time.Time) *Fake

+ func (f *Fake) Advance(d time.Duration)

+ func (f *Fake) NewTimer(d time.Duration) Timer

+ func (f *Fake) Now() time.Time

+ func (f *Fake) Timers() int

+ func (f *Fake) WaitForTimers(n int)

+ func (f *Fake) WithTimeout(parent context.Context, d time.Duration) (context.Context, context.CancelFunc)

+ type Timer interface

+ C func() <-chan time.Time

+ Reset func(d time.Duration)

+ Stop func()