fastime

README

fastime is a super fast time function library for Go with zero memory allocation. fastime returns the approximate time.

Requirement

Go 1.16

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=10 -run=NONE -bench . -benchmem
goos: linux
goarch: amd64
pkg: github.com/kpango/fastime
BenchmarkFastime-8   	2000000000	         0.45 ns/op	       0 B/op	       0 allocs/op
BenchmarkFastime-8   	2000000000	         0.45 ns/op	       0 B/op	       0 allocs/op
BenchmarkFastime-8   	2000000000	         0.45 ns/op	       0 B/op	       0 allocs/op
BenchmarkFastime-8   	2000000000	         0.45 ns/op	       0 B/op	       0 allocs/op
BenchmarkFastime-8   	2000000000	         0.45 ns/op	       0 B/op	       0 allocs/op
BenchmarkFastime-8   	2000000000	         0.45 ns/op	       0 B/op	       0 allocs/op
BenchmarkFastime-8   	2000000000	         0.45 ns/op	       0 B/op	       0 allocs/op
BenchmarkFastime-8   	2000000000	         0.45 ns/op	       0 B/op	       0 allocs/op
BenchmarkFastime-8   	2000000000	         0.45 ns/op	       0 B/op	       0 allocs/op
BenchmarkFastime-8   	2000000000	         0.46 ns/op	       0 B/op	       0 allocs/op
BenchmarkTime-8      	 1000000	      1683 ns/op	       0 B/op	       0 allocs/op
BenchmarkTime-8      	 1000000	      1720 ns/op	       0 B/op	       0 allocs/op
BenchmarkTime-8      	 1000000	      1688 ns/op	       0 B/op	       0 allocs/op
BenchmarkTime-8      	 1000000	      1716 ns/op	       0 B/op	       0 allocs/op
BenchmarkTime-8      	 1000000	      1691 ns/op	       0 B/op	       0 allocs/op
BenchmarkTime-8      	 1000000	      1693 ns/op	       0 B/op	       0 allocs/op
BenchmarkTime-8      	 1000000	      1703 ns/op	       0 B/op	       0 allocs/op
BenchmarkTime-8      	 1000000	      1668 ns/op	       0 B/op	       0 allocs/op
BenchmarkTime-8      	 1000000	      1685 ns/op	       0 B/op	       0 allocs/op
BenchmarkTime-8      	 1000000	      1716 ns/op	       0 B/op	       0 allocs/op
PASS
ok  	github.com/kpango/fastime	26.873s

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