clock

Documentation

Index

• type Clock
• type Timer

Types

type Clock

type Clock interface {
	// Return the current time of day. Equivalent to time.Now().
	Now() time.Time

	// Create a Context object that automatically cancels after a
	// certain amount of time has passed. Equivalent to
	// context.WithTimeout().
	NewContextWithTimeout(parent context.Context, timeout time.Duration) (context.Context, context.CancelFunc)

	// Create a channel that publishes the time of day at a point of
	// time in the future. Unlike time.NewTimer(), this function
	// returns the channel directly to allow Timer to be an
	// interface.
	NewTimer(d time.Duration) (Timer, <-chan time.Time)
}

Clock is an interface around some of the standard library functions that provide time handling. It has been added to aid unit testing.

var SystemClock Clock = systemClock{}

SystemClock is a Clock that corresponds to the current time of day, as reported by the operating system.

type Timer

type Timer interface {
	Stop() bool
}

Timer is an interface around time.Timer. It has been added to aid unit testing.