timeutil

Documentation

Index

• Constants
• func DateTime(format string, datetime any) template.HTML
• func GetExecutableModTime() time.Time
• func MinutesToFriendly(minutes int, lang translation.Locale) string
• func Set(now time.Time)
• func TimeSince(then time.Time, lang translation.Locale) template.HTML
• func TimeSincePro(then time.Time, lang translation.Locale) string
• func TimeSinceUnix(then TimeStamp, lang translation.Locale) template.HTML
• func Unset()
• type TimeStamp
  • func TimeStampNow() TimeStamp
  • func (ts TimeStamp) Add(seconds int64) TimeStamp
  • func (ts TimeStamp) AddDuration(interval time.Duration) TimeStamp
  • func (ts TimeStamp) AsLocalTime() time.Time
  • func (ts TimeStamp) AsTime() (tm time.Time)
  • func (ts TimeStamp) AsTimeInLocation(loc *time.Location) time.Time
  • func (ts TimeStamp) AsTimePtr() *time.Time
  • func (ts TimeStamp) AsTimePtrInLocation(loc *time.Location) *time.Time
  • func (ts TimeStamp) Format(f string) string
  • func (ts TimeStamp) FormatDate() string
  • func (ts TimeStamp) FormatInLocation(f string, loc *time.Location) string
  • func (ts TimeStamp) FormatLong() string
  • func (ts TimeStamp) FormatShort() string
  • func (ts TimeStamp) IsZero() bool
  • func (ts TimeStamp) Year() int
• type TimeStampNano
  • func TimeStampNanoNow() TimeStampNano
  • func (tsn TimeStampNano) AsTime() (tm time.Time)
  • func (tsn TimeStampNano) AsTimeInLocation(loc *time.Location) time.Time

Constants

const (
	Minute = 60
	Hour   = 60 * Minute
	Day    = 24 * Hour
	Week   = 7 * Day
	Month  = 30 * Day
	Year   = 12 * Month
)

Seconds-based time units

Functions

func DateTime

func DateTime(format string, datetime any) template.HTML

DateTime renders an absolute time HTML element by datetime.

func GetExecutableModTime

func GetExecutableModTime() time.Time

GetExecutableModTime get executable file modified time of current process.

func MinutesToFriendly

func MinutesToFriendly(minutes int, lang translation.Locale) string

MinutesToFriendly returns a user friendly string with number of minutes converted to hours and minutes.

func Set

func Set(now time.Time)

Set sets the time to a mocked time.Time

func TimeSince

func TimeSince(then time.Time, lang translation.Locale) template.HTML

TimeSince renders relative time HTML given a time.Time

func TimeSincePro

func TimeSincePro(then time.Time, lang translation.Locale) string

TimeSincePro calculates the time interval and generate full user-friendly string.

func TimeSinceUnix

func TimeSinceUnix(then TimeStamp, lang translation.Locale) template.HTML

TimeSinceUnix renders relative time HTML given a TimeStamp

func Unset

func Unset()

Unset will unset the mocked time.Time

Types

type TimeStamp

type TimeStamp int64

TimeStamp defines a timestamp

func TimeStampNow

func TimeStampNow() TimeStamp

TimeStampNow returns now int64

func (TimeStamp) Add

func (ts TimeStamp) Add(seconds int64) TimeStamp

Add adds seconds and return sum

func (TimeStamp) AddDuration

func (ts TimeStamp) AddDuration(interval time.Duration) TimeStamp

AddDuration adds time.Duration and return sum

func (TimeStamp) AsLocalTime

func (ts TimeStamp) AsLocalTime() time.Time

AsLocalTime convert timestamp as time.Time in local location

func (TimeStamp) AsTime

func (ts TimeStamp) AsTime() (tm time.Time)

AsTime convert timestamp as time.Time in Local locale

func (TimeStamp) AsTimeInLocation

func (ts TimeStamp) AsTimeInLocation(loc *time.Location) time.Time

AsTimeInLocation convert timestamp as time.Time in Local locale

func (TimeStamp) AsTimePtr

func (ts TimeStamp) AsTimePtr() *time.Time

AsTimePtr convert timestamp as *time.Time in Local locale

func (TimeStamp) AsTimePtrInLocation

func (ts TimeStamp) AsTimePtrInLocation(loc *time.Location) *time.Time

AsTimePtrInLocation convert timestamp as *time.Time in customize location

func (TimeStamp) Format

func (ts TimeStamp) Format(f string) string

Format formats timestamp as given format

func (TimeStamp) FormatDate

func (ts TimeStamp) FormatDate() string

FormatDate formats a date in YYYY-MM-DD server time zone

func (TimeStamp) FormatInLocation

func (ts TimeStamp) FormatInLocation(f string, loc *time.Location) string

FormatInLocation formats timestamp as given format with spiecific location

func (TimeStamp) FormatLong

func (ts TimeStamp) FormatLong() string

FormatLong formats as RFC1123Z

func (TimeStamp) FormatShort

func (ts TimeStamp) FormatShort() string

FormatShort formats as short

func (TimeStamp) IsZero

func (ts TimeStamp) IsZero() bool

IsZero is zero time

func (TimeStamp) Year

func (ts TimeStamp) Year() int

Year returns the time's year

type TimeStampNano

type TimeStampNano int64

TimeStampNano is for nano time in database, do not use it unless there is a real requirement.

func TimeStampNanoNow

func TimeStampNanoNow() TimeStampNano

TimeStampNanoNow returns now nano int64

func (TimeStampNano) AsTime

func (tsn TimeStampNano) AsTime() (tm time.Time)

AsTime convert timestamp as time.Time in Local locale

func (TimeStampNano) AsTimeInLocation

func (tsn TimeStampNano) AsTimeInLocation(loc *time.Location) time.Time

AsTimeInLocation convert timestamp as time.Time in Local locale