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 FormattedNow() []byte
• func Now() time.Time
• func Stop()
• func UnixNanoNow() int64
• func UnixNow() int64
• func UnixUNanoNow() uint32
• func UnixUNow() uint32
• type Fastime
  • func New() *Fastime
  • func SetFormat(format string) *Fastime
  • func StartTimerD(ctx context.Context, dur time.Duration) *Fastime
  • func (f *Fastime) FormattedNow() []byte
  • func (f *Fastime) Now() time.Time
  • func (f *Fastime) SetFormat(format string) *Fastime
  • func (f *Fastime) StartTimerD(ctx context.Context, dur time.Duration) *Fastime
  • func (f *Fastime) Stop()
  • func (f *Fastime) UnixNanoNow() int64
  • func (f *Fastime) UnixNow() int64
  • func (f *Fastime) UnixUNanoNow() uint32
  • func (f *Fastime) UnixUNow() uint32

Functions

func FormattedNow

func FormattedNow() []byte

FormattedNow returns formatted byte time

func Now

func Now() time.Time

Now returns current time

func Stop

func Stop()

Stop stops stopping time refresh daemon

func UnixNanoNow

func UnixNanoNow() int64

UnixNanoNow returns current unix nano time

func UnixNow

func UnixNow() int64

UnixNow returns current unix time

func UnixUNanoNow

func UnixUNanoNow() uint32

UnixNanoNow returns current unix nano time

func UnixUNow

func UnixUNow() uint32

UnixNow returns current unix time

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 SetFormat

func SetFormat(format string) *Fastime

SetFormat replaces time format

func StartTimerD

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

StartTimerD provides time refresh daemon

func (*Fastime) FormattedNow

func (f *Fastime) FormattedNow() []byte

FormattedNow returns formatted byte time

func (*Fastime) Now

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

Now returns current time

func (*Fastime) SetFormat

func (f *Fastime) SetFormat(format string) *Fastime

SetFormat replaces time format

func (*Fastime) StartTimerD

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

StartTimerD provides time refresh daemon

func (*Fastime) Stop

func (f *Fastime) Stop()

Stop stops stopping time refresh daemon

func (*Fastime) UnixNanoNow

func (f *Fastime) UnixNanoNow() int64

UnixNanoNow returns current unix nano time

func (*Fastime) UnixNow

func (f *Fastime) UnixNow() int64

UnixNow returns current unix time

func (*Fastime) UnixUNanoNow

func (f *Fastime) UnixUNanoNow() uint32

UnixNanoNow returns current unix nano time

func (*Fastime) UnixUNow

func (f *Fastime) UnixUNow() uint32

UnixNow returns current unix time