time

package
v1.8.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Feb 10, 2026 License: MIT, Apache-2.0 Imports: 12 Imported by: 11

Documentation

Index

Constants

View Source 
const (
	InvalidNil
	InvalidUnderflow
	InvalidOverflow
	InvalidNanos
)
View Source 
const (
	LayoutTimeMacro   = "2006-01-02 15:04:05.999999"
	LayoutCompactDate = "20060102"
	LayoutCompactTime = "20060102150405"
	LayoutRFC1        = "2006/01/02 - 15:04:05"
)
View Source 
const (
	DayEndTime            = "23:59:59"
	DayEndTimeWithSpace   = " 23:59:59"
	DayBeginTime          = "00:00:00"
	DayBeginTimeWithSpace = " 00:00:00"
)
View Source 
const (
	Day             = time.Hour * 24
	MonthDay30      = Day * 30
	MonthDay31      = Day * 31
	MonthDay28      = Day * 28
	MonthDay29      = Day * 29
	Month           = MonthDay30
	YearDay365      = Day * 365
	YearDay366      = Day * 366
	Year            = YearDay365
	SecondsOfDay    = HoursOfDay * SecondsOfHour
	SecondsOfMinute = 60
	SecondsOfHour   = MinutesOfHour * SecondsOfMinute
	MinutesOfHour   = 60
	MinutesOfDay    = MinutesOfHour * HoursOfDay
	HoursOfDay      = 24
)
View Source 
const (
	January   = "January"
	February  = "February"
	March     = "March"
	April     = "April"
	May       = "May"
	June      = "June"
	July      = "July"
	August    = "August"
	September = "September"
	October   = "October"
	November  = "November"
	December  = "December"
)
View Source 
const (
	Monday    = "Monday"
	Tuesday   = "Tuesday"
	Wednesday = "Wednesday"
	Thursday  = "Thursday"
	Friday    = "Friday"
	Saturday  = "Saturday"
	Sunday    = "Sunday"
)

Variables

View Source 
var (
	DefaultEncoding = &Encoding{
		Layout: time.RFC3339Nano,
	}
	EncodingUnixSeconds = &Encoding{
		encodeType: encodeTypeUnixSeconds,
	}
	EncodingUnixMilliseconds = &Encoding{
		encodeType: encodeTypeUnixMilliseconds,
	}
	EncodingUnixMicroseconds = &Encoding{
		encodeType: encodeTypeUnixMicroseconds,
	}
	EncodingUnixNanoseconds = &Encoding{
		encodeType: encodeTypeUnixNanoseconds,
	}
)
View Source 
var ZeroTime = time.Time{}

Functions

func Check 

func Check(x Time) uint

func CheckValid 

func CheckValid(x Time) error

func FormatRelativeTime 

func FormatRelativeTime(fromTime time.Time) string

func GetTomorrowYMD 

func GetTomorrowYMD(sep string) string

GetTomorrowYMD 得到以sep为分隔符的年、月、日字符串(明天)

func GetYM 

func GetYM(time time.Time, sep string) string

GetYM 得到以sep为分隔符的年、月字符串(今天所属于的月份)

func GetYMD 

func GetYMD(time time.Time, sep string) string

GetTodayYMD 得到以sep为分隔符的年、月、日字符串(今天)

func GetYesterdayYMD 

func GetYesterdayYMD(sep string) string

GetYesterdayYMD 得到以sep为分隔符的年、月、日字符串(昨天)

func IsValid 

func IsValid(x Time) bool

func MarshalJSON 

func MarshalJSON(t time.Time) ([]byte, error)

func MarshalText 

func MarshalText(t time.Time) ([]byte, error)

func NormalizeDuration added in v1.3.20 

func NormalizeDuration(td time.Duration, stdTd time.Duration) time.Duration

标准化Duration

func ParseDate 

func ParseDate(t string) (time.Time, error)

func ParseDateTime 

func ParseDateTime(t string) (time.Time, error)

func ParseTime 

func ParseTime(t string) (time.Time, error)

func SetSysTime added in v1.3.20 

func SetSysTime(t time.Time)

设置系统时间

func StrToIntMonth 

func StrToIntMonth(month string) int

StrToIntMonth 字符串月份转整数月份

func SyncHwTime 

func SyncHwTime()

func TodayZeroTime 

func TodayZeroTime() time.Time

TodayZeroTime 返回今天零点的time

func UnixNano 

func UnixNano(nsec int64) time.Time

func UnmarshalJSON 

func UnmarshalJSON(t *time.Time, data []byte) error

func UnmarshalText 

func UnmarshalText(t *time.Time, data []byte) error

func YesterdayZeroTime added in v1.6.3 

func YesterdayZeroTime() time.Time

YesterdayZeroTime 返回昨天零点的time

Types

type Date 

type Date int32

1-01-01~9999-12-31

func DateFromTime 

func DateFromTime(t time.Time) Date

func DateTimeFromTime 

func DateTimeFromTime(t time.Time) Date

func (*Date) GobDecode 

func (d *Date) GobDecode(data []byte) error

func (Date) GobEncode 

func (d Date) GobEncode() ([]byte, error)

func (Date) GormDataType 

func (d Date) GormDataType() string

func (Date) MarshalBinary 

func (d Date) MarshalBinary() ([]byte, error)

func (Date) MarshalGQL 

func (d Date) MarshalGQL(w io.Writer)

func (Date) MarshalJSON 

func (d Date) MarshalJSON() ([]byte, error)

func (Date) MarshalText 

func (d Date) MarshalText() ([]byte, error)

func (*Date) Scan 

func (d *Date) Scan(value interface{}) (err error)

Scan scan time.

func (Date) String 

func (d Date) String() string

func (Date) Time 

func (d Date) Time() time.Time

func (*Date) UnmarshalBinary 

func (d *Date) UnmarshalBinary(data []byte) error

UnmarshalBinary implements the DefaultEncoding.BinaryUnmarshaler interface.

func (*Date) UnmarshalGQL 

func (d *Date) UnmarshalGQL(v interface{}) error

func (*Date) UnmarshalJSON 

func (d *Date) UnmarshalJSON(data []byte) error

func (*Date) UnmarshalText 

func (d *Date) UnmarshalText(data []byte) error

func (Date) Value 

func (d Date) Value() (driver.Value, error)

Value get time value.

type DateTime 

type DateTime int64

01-01-01 00:00:00~9999-12-31 23:59:59

func (DateTime) Date 

func (ts DateTime) Date() Date

func (DateTime) GormDataType 

func (ts DateTime) GormDataType() string

func (DateTime) MarshalJSON 

func (d DateTime) MarshalJSON() ([]byte, error)

func (DateTime) MarshalText 

func (d DateTime) MarshalText() ([]byte, error)

func (*DateTime) Scan 

func (d *DateTime) Scan(value interface{}) (err error)

Scan scan time.

func (DateTime) Time 

func (d DateTime) Time() time.Time

func (*DateTime) UnmarshalJSON 

func (d *DateTime) UnmarshalJSON(data []byte) error

func (*DateTime) UnmarshalText 

func (d *DateTime) UnmarshalText(data []byte) error

func (DateTime) Value 

func (d DateTime) Value() (driver.Value, error)

Value get time value.

type Duration 

type Duration int64

Duration be used toml unmarshal string time, like 1s, 500ms.

func (Duration) MarshalJSON added in v1.6.7 

func (t Duration) MarshalJSON() ([]byte, error)

func (Duration) MarshalText 

func (d Duration) MarshalText() ([]byte, error)

func (Duration) Shrink 

func (d Duration) Shrink(c context.Context) (Duration, context.Context, context.CancelFunc)

Shrink will decrease the duration by comparing with context's timeout duration and return new timeout\context\CancelFunc.

func (*Duration) UnmarshalJSON added in v1.6.7 

func (t *Duration) UnmarshalJSON(data []byte) error

UnmarshalJSON implements the encoding/json.Unmarshaler interface. The time must be a quoted string in the RFC 3339 format.

func (*Duration) UnmarshalText 

func (d *Duration) UnmarshalText(text []byte) error

UnmarshalText unmarshal text to duration.

type Encoding 

type Encoding struct {
	Layout string
	// contains filtered or unexported fields
}

func NewLayOutEncoding added in v1.7.18 

func NewLayOutEncoding(layout string) *Encoding

type EncodingTime 

type EncodingTime struct {
	time.Time
	*Encoding
}

func (EncodingTime) MarshalJSON 

func (u EncodingTime) MarshalJSON() ([]byte, error)

func (*EncodingTime) UnmarshalJSON 

func (u *EncodingTime) UnmarshalJSON(data []byte) error

type FixedTicker added in v1.7.18 

type FixedTicker time.Ticker

func (*FixedTicker) Channel added in v1.7.18 

func (t *FixedTicker) Channel() <-chan time.Time

func (*FixedTicker) Reset added in v1.7.18 

func (t *FixedTicker) Reset(d time.Duration) bool

func (*FixedTicker) Stop added in v1.7.18 

func (t *FixedTicker) Stop() bool

func (*FixedTicker) Wait added in v1.7.18 

func (t *FixedTicker) Wait()

type GlobEncodingTime added in v1.3.20 

type GlobEncodingTime time.Time

func (GlobEncodingTime) MarshalJSON added in v1.3.20 

func (u GlobEncodingTime) MarshalJSON() ([]byte, error)

func (*GlobEncodingTime) UnmarshalJSON added in v1.3.20 

func (u *GlobEncodingTime) UnmarshalJSON(data []byte) error

type RandTicker 

type RandTicker struct {
	// contains filtered or unexported fields
}

func (*RandTicker) Channel 

func (t *RandTicker) Channel() <-chan time.Time

func (*RandTicker) Reset 

func (t *RandTicker) Reset(d time.Duration) bool

设置最小间隔

func (*RandTicker) Stop 

func (t *RandTicker) Stop() bool

func (*RandTicker) Wait 

func (t *RandTicker) Wait()

type Ticker 

type Ticker interface {
	Reset(time.Duration) bool
	Stop() bool
	Wait()
	Channel() <-chan time.Time
}

func NewRandTicker 

func NewRandTicker(minInterval, maxInterval time.Duration) Ticker

minInterval:最小等待时间 maxInterval：最大等待时间 maxInterval-minInterval: 等待范围

func NewTicker 

func NewTicker(interval time.Duration) Ticker

type Time 

type Time interface {
	GetSeconds() int64
	GetNanos() int32
}

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.