timestamp

README

timestamp

The timestamp package implements an alternative UTC type that encodes efficiently and safely on the client-side. Values use microsecond precision, the zero point is 1-1-1900 0:00 UTC. The encoding uses only 52 bits to fit safely in a IEEE double floating point value. This ensures compatibility with the Javascript number type.

There are a number of advantages timestamp has over using the official Time data type:

• straightforward, compact encoding as a single int64 or double in memory and storage
• due to always being UTC, no problems with timezones
• direct compatiblity with Javascript or any other programming language that can handle 64bit integers
• vendor-agnostic storage in databases as simple 64bit integer

Documentation

Index

• func Diff(ts1, ts2 TS) int64
• type TS
  • func Duration(d time.Duration) TS
  • func DurationMS(millisecs int) TS
  • func Make(t time.Time) TS
  • func Now() TS
  • func Unix(ut int64) TS
  • func (ts TS) Duration() time.Duration
  • func (ts TS) Int64() int64
  • func (ts TS) Milliseconds() float64
  • func (ts TS) Seconds() float64
  • func (ts TS) String() string
  • func (ts TS) Time() time.Time
  • func (ts TS) Unix() int64

Functions

func Diff

func Diff(ts1, ts2 TS) int64

Diff returns the differens (ts2-ts1) in millisecs

Types

type TS

type TS int64

TS encodes UTC time with microsecond resolution with a starting point of 1-1-1900 00:00 UTC

func Duration

func Duration(d time.Duration) TS

Duration converts a Duration value into a (relative) TS

func DurationMS

func DurationMS(millisecs int) TS

DurationMS creates a duration (offset) TS value from milliseconds

func Make

func Make(t time.Time) TS

Make converts a Time value into a TS

func Now

func Now() TS

Now returns the current time as a TS

func Unix

func Unix(ut int64) TS

Unix converts a Unix Epoch Time value into a TS timestamp

func (TS) Duration

func (ts TS) Duration() time.Duration

Duration converts a TS value into a golang time.Duration value

func (TS) Int64

func (ts TS) Int64() int64

Int64 type-casts back to int64

func (TS) Milliseconds

func (ts TS) Milliseconds() float64

Milliseconds returns the absolute number of seconds since the base date (1/1/1900)

func (TS) Seconds

func (ts TS) Seconds() float64

Seconds returns the absolute number of seconds since the base date (1/1/1900)

func (TS) String

func (ts TS) String() string

String implements fmt.Stringer

func (TS) Time

func (ts TS) Time() time.Time

Time converts a TS value into a golang time.Time value

func (TS) Unix

func (ts TS) Unix() int64

Unix converts into Unix Epoch Time