timeutils

Documentation

Overview

Package idutils provides a set of helper functions to convert ids.

Functions in big_endian_converter.go help converting uint64 ids to TraceID and SpanID using big endian, and vice versa.

Index

• Variables
• func GetLocation(location *string, layout *string) (*time.Location, error)
• func ParseGotime(layout string, value any, location *time.Location) (time.Time, error)
• func ParseLocalizedGotime(layout string, value any, location *time.Location, language string) (time.Time, error)
• func ParseLocalizedStrptime(layout string, value any, location *time.Location, language string) (time.Time, error)
• func ParseStrptime(layout string, value any, location *time.Location) (time.Time, error)
• func SetTimestampYear(t time.Time) time.Time
• func StrptimeToGotime(layout string) (string, error)
• func ValidateGotime(layout string) error
• func ValidateLocale(locale string) error
• func ValidateStrptime(layout string) error
• type PolicyTicker
  • func (pt *PolicyTicker) OnTick()
  • func (pt *PolicyTicker) Start(d time.Duration)
  • func (pt *PolicyTicker) Stop()
• type TTicker

Variables

var Now = time.Now

Allows tests to override with deterministic value

Functions

func GetLocation

func GetLocation(location *string, layout *string) (*time.Location, error)

func ParseGotime

func ParseGotime(layout string, value any, location *time.Location) (time.Time, error)

func ParseLocalizedGotime

func ParseLocalizedGotime(layout string, value any, location *time.Location, language string) (time.Time, error)

ParseLocalizedGotime is like ParseGotime, but instead of parsing a formatted time in English, it parses a value in foreign language, and returns the time.Time it represents. The language argument must be a well-formed BCP 47 language tag (e.g.: "en", "en-US"), and a known CLDR locale.

func ParseLocalizedStrptime

func ParseLocalizedStrptime(layout string, value any, location *time.Location, language string) (time.Time, error)

ParseLocalizedStrptime is like ParseLocalizedGotime, but instead of using the native Go time layout, it uses the ctime-like format.

func ParseStrptime

func ParseStrptime(layout string, value any, location *time.Location) (time.Time, error)

func SetTimestampYear

func SetTimestampYear(t time.Time) time.Time

SetTimestampYear sets the year of a timestamp to the current year. This is needed because year is missing from some time formats, such as rfc3164.

func StrptimeToGotime

func StrptimeToGotime(layout string) (string, error)

func ValidateGotime

func ValidateGotime(layout string) error

func ValidateLocale

func ValidateLocale(locale string) error

ValidateLocale checks the given locale and returns an error if the language tag is not supported by the localized parser functions.

func ValidateStrptime

func ValidateStrptime(layout string) error

ValidateStrptime checks the given strptime layout and returns an error if it detects any known issues that prevent it from being parsed.

Types

type PolicyTicker

type PolicyTicker struct {
	Ticker     *time.Ticker
	OnTickFunc func()
	StopCh     chan struct{}
}

Implements TTicker and abstracts underlying time ticker's functionality to make usage simpler.

func (*PolicyTicker) OnTick

func (pt *PolicyTicker) OnTick()

func (*PolicyTicker) Start

func (pt *PolicyTicker) Start(d time.Duration)

func (*PolicyTicker) Stop

func (pt *PolicyTicker) Stop()

type TTicker

type TTicker interface {
	// start sets the frequency of the Ticker and starts the periodic calls to OnTick.
	Start(d time.Duration)
	// OnTick is called when the Ticker fires.
	OnTick()
	// Stop firing the Ticker.
	Stop()
}

TTicker interface allows easier testing of Ticker related functionality