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().StartTimerD(context.Background(), time.Millisecond*5)
    defer fastime.Stop()

    // Create Instance
    ft := fastime.New().StartTimerD(context.Background(), time.Millisecond*5)
    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() (now []byte)
• func GetFormat() (form string)
• func GetLocation() (loc *time.Location)
• func IsDaemonRunning() (running bool)
• func Now() (now time.Time)
• func Since(t time.Time) (dur time.Duration)
• func Stop()
• func UnixNanoNow() (now int64)
• func UnixNow() (now int64)
• func UnixUNanoNow() (now uint32)
• func UnixUNow() (now uint32)
• type Fastime
  • func New() (f Fastime)
  • func SetFormat(format string) (ft Fastime)
  • func SetLocation(location *time.Location) (ft Fastime)
  • func StartTimerD(ctx context.Context, dur time.Duration) (ft Fastime)

Functions

func FormattedNow

func FormattedNow() (now []byte)

FormattedNow returns formatted byte time

func GetFormat

func GetFormat() (form string)

func GetLocation

func GetLocation() (loc *time.Location)

func IsDaemonRunning

func IsDaemonRunning() (running bool)

func Now

func Now() (now time.Time)

Now returns current time

func Since

func Since(t time.Time) (dur time.Duration)

Since returns the time elapsed since t. It is shorthand for fastime.Now().Sub(t).

func Stop

func Stop()

Stop stops stopping time refresh daemon

func UnixNanoNow

func UnixNanoNow() (now int64)

UnixNanoNow returns current unix nano time

func UnixNow

func UnixNow() (now int64)

UnixNow returns current unix time

func UnixUNanoNow

func UnixUNanoNow() (now uint32)

UnixUNanoNow returns current unix nano time

func UnixUNow

func UnixUNow() (now uint32)

UnixUNow returns current unix time

Types

type Fastime

type Fastime interface {
	IsDaemonRunning() bool
	GetFormat() string
	SetFormat(format string) Fastime
	GetLocation() *time.Location
	SetLocation(location *time.Location) Fastime
	Now() time.Time
	Stop()
	UnixNow() int64
	UnixUNow() uint32
	UnixNanoNow() int64
	UnixUNanoNow() uint32
	FormattedNow() []byte
	Since(t time.Time) time.Duration
	StartTimerD(ctx context.Context, dur time.Duration) Fastime
}

func New

func New() (f Fastime)

New returns Fastime

func SetFormat

func SetFormat(format string) (ft Fastime)

SetFormat replaces time format

func SetLocation

func SetLocation(location *time.Location) (ft Fastime)

SetLocation replaces time location

func StartTimerD

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

StartTimerD provides time refresh daemon