fastime

README

fastime

Blazing Fast Time Library for golang with zero allocs

Requirement

Go 1.8

Installation

go get github.com/kpango/fastime

Example

    now := fastime.Now()
    defer fastime.Stop()

    // Create Instance
    ft := fastime.New()
    defer ft.Stop()
    ft.Now()

Benchmark

go test -count=5 -run=NONE -bench . -benchmem
goos: darwin
goarch: amd64
pkg: github.com/kpango/fastime
BenchmarkFastime-8   	2000000000	         0.47 ns/op	       0 B/op	       0 allocs/op
BenchmarkFastime-8   	2000000000	         0.48 ns/op	       0 B/op	       0 allocs/op
BenchmarkFastime-8   	2000000000	         0.48 ns/op	       0 B/op	       0 allocs/op
BenchmarkFastime-8   	2000000000	         0.47 ns/op	       0 B/op	       0 allocs/op
BenchmarkFastime-8   	2000000000	         0.47 ns/op	       0 B/op	       0 allocs/op
BenchmarkTime-8      	100000000	        16.6 ns/op	       1 B/op	       0 allocs/op
BenchmarkTime-8      	100000000	        15.4 ns/op	       1 B/op	       0 allocs/op
BenchmarkTime-8      	100000000	        15.6 ns/op	       1 B/op	       0 allocs/op
BenchmarkTime-8      	100000000	        15.6 ns/op	       1 B/op	       0 allocs/op
BenchmarkTime-8      	100000000	        14.9 ns/op	       1 B/op	       0 allocs/op
PASS
ok  	github.com/kpango/fastime	12.936s

Contribution

1. Fork it ( https://github.com/kpango/fastime/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

Author

kpango

LICENSE

fastime released under MIT license, refer LICENSE file.

Documentation

Index

• func Now() time.Time
• func Stop()
• type Fastime
  • func New() *Fastime
  • func SetDuration(dur time.Duration) *Fastime
  • func StartTimerD(ctx context.Context, dur time.Duration) *Fastime
  • func (f *Fastime) Now() time.Time
  • func (f *Fastime) SetDuration(dur time.Duration) *Fastime
  • func (f *Fastime) StartTimerD(ctx context.Context, dur time.Duration) *Fastime
  • func (f *Fastime) Stop()

Functions

func Now

func Now() time.Time

Now returns current time

func Stop

func Stop()

Stop stops stopping time refresh daemon

Types

type Fastime

type Fastime struct {
	// contains filtered or unexported fields
}

Fastime is fastime's base struct, it's stores atomic time object

func New

func New() *Fastime

New returns Fastime

func SetDuration

func SetDuration(dur time.Duration) *Fastime

SetDuration changes time refresh duration

func StartTimerD

func StartTimerD(ctx context.Context, dur time.Duration) *Fastime

func (*Fastime) Now

func (f *Fastime) Now() time.Time

Now returns current time

func (*Fastime) SetDuration

func (f *Fastime) SetDuration(dur time.Duration) *Fastime

SetDuration changes time refresh duration

func (*Fastime) StartTimerD

func (f *Fastime) StartTimerD(ctx context.Context, dur time.Duration) *Fastime

func (*Fastime) Stop

func (f *Fastime) Stop()

Stop stops stopping time refresh daemon