timer

Documentation

Overview

Package timer is a small convenience package for timing blocks of code.

Example

Example of combining a timer with a defer to make it easy to put all your timing code at the top of a function.

defer func(t Timer) {
	dur := t.Finish()
	fmt.Printf("log my duration as %g\n", dur)
}(Start())

Example (Block)

Example_block when timing non-funciton based locks, separate the start and finish

// do some work
t := Start()
// do some more work
dur := t.Finish()
fmt.Printf("log my duration as %g\n", dur)

Example (OtherTime)

Example_othertime for when starting from Now isn't quite right

actualStart := time.Unix(1525150486, 0)
t := New(actualStart)
// do some work
dur := t.Finish()
fmt.Printf("log my duration as %g\n", dur)

Index

• type Timer
  • func New(t time.Time) Timer
  • func Start() Timer

Examples

• Package
• Package (Block)
• Package (OtherTime)

Types

type Timer

type Timer interface {
	// Finish calculates the time since the timer was started and returns its
	// representation in milliseconds
	Finish() float64
}

Timer is the thing that you pass around to time blocks of code. Represented as an interface so that other implementations can do fancy things with the values in addition to just returning them, such as submit them to instrumentation frameworks.

func New

func New(t time.Time) Timer

New creates a new timer with an arbitrary starting time

func Start

func Start() Timer

Start creates a new timer using `time.Now()` as the starting time